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Changing Windows™ Applications into OS/2" Applications Is 

A Neat Trick Done With Mirrors 


M icrografx Mirrors can help you 
work magic. You can reach 
over a million new users for 
the price of an inexpensive tool kit. 

With Mirrors, you can maintain an 
application for two operating systems 
with a single set of 
source. This means 
you aren’t forced to 
choose between 
operating systems, 
and you won’t get 
bogged down in ver¬ 
sion control prob¬ 
lems and divided 
development efforts. 

Get the 

advantages of OS/2: 
access to a true 
multi-tasking operat¬ 
ing system, 32-bit architecture, a more 
stable platform, integration with other 
OS/2 applications, and a clear migration 
path — not to mention the advantage of 
a million new customers. 

How does it work? It’s simple. 
Mirrors emulates Windows. When your 


application, running under OS/2, calls a 
Windows function, Mirrors intercepts the 
call. Mirrors then implements it using 
functions within the OS/2 system DLLs. 
Mirrors transforms data returned by OS/2 
and passes it back in a form that 

Windows applications 
understand. Your 
application may never 
know that it’s not 
running under 
Windows. 

What do you 
need to do to make 
this happen? First, 
run Micrografx’s con¬ 
version utilities on 
your application’s 
resources, then re-link 
with the Mirrors 
DLL. That’s it. Using Mirrors, you 
may not even need to recompile. 
Micrografx developed the Mirrors technol¬ 
ogy. That means this tool kit was writ¬ 
ten by Windows developers for Windows 
developers. Mirrors is fast and inexpen¬ 
sive. Look into it! 



To Purchase your copy of Mirrors today, call (214) 994-6566. 

To learn more about how this trick is done, 
call Micrografx Technical Support for Mirrors at (214) 994-6659. 

• Mirrors is a 32-bit DLL for increased performance • 32-bit Mirrors DLL provides support for 16-bit applications 
■ Non-debug and debug version of Mirrors DLL provide handle validation and error reporting 
■ Automated conversion of Help, bitmaps, cursors, and icons ■ Includes DOS and OS/2 host independent file HO libraries 
■ Interrupt 21 directly supported with no need to modify ASM files ■ DOS3CALL interrupt support 
■ Dynamic Data Exchange support with native PM applications ■ Mirrors also supports Clipboard data sharing 

MICROGRAFX® 

Micrografx, Inc. 1303 Arapaho, Richardson, TX 75081. Copyright © 1992, Micrografx, Inc. All rights reserved. Micrografx is a registered trademark 
of Micrografx, Inc. Windows is a trademark of Microsoft. OS/2 is a registered trademark of IBM Corporation. All other products are trademarks or 
registered trademarks of their respective owners. Mirrors is a trademark of Micrografx, Inc. Micrografx Mirrors is not affiliated with Softklone 

Distributing Corporation or Softklone's MIRROR data communications products. 
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800 - 755-8649 


Who Do You Call When You Need NT Connections? 

NTDirect, your one source for Windows NT™ <o Unix connectivity 

Yes, we know that Windows NT hasn't really shipped yet (at least not when this ad was created) but we want you to 
know that there is a company dedicated to bringing you the best NT products at the best prices. And anyone moving to 
NT needs windows and Unix connectivity products today. As NT goes gold we expect that all the products you see in this 
ad will start shipping an NT version. Development tools such as SlickEdit and SourceSafe are already available. Now 
you know where to get them. Call us today and we'll keep you on our mailing list for the latest tools. We ship everything 
via Federal Express to ensure on-tiine delivery within 2 business days. 3 days to most of Europe. 


SourceSafe 

project oriented version control 



ONE TREE Software 


Project oriented 
version control 

SourceSafe is the cross-platform project 
oriented version control software that does¬ 
n't try and write your program for you. It 
takes care of your maintenance and tracking 
responsibilities, freeing Windows NT 
you up to concentrate on 
programming. Also avail- 
able for Unix. Call. ^ 


"SlickEdit is the only 
editor I use" 

- Dave Cutler, Director of Windows NT Development. 

PC Week added “overall, the easiest editor to learn and 1 
use.” Full undo and redo (32,767 steps!), procedure tagging, 
on-line manual, run compiler from editor, multiple clipboard ’ 
support, expression search and replace, 
Windows NT d 0Cum ent math, and a typeless REXX-like ’ 
* • OC macro language. Also for SCO Unix, AIX, HP-UX, 


SunOS, DOS and Windows. 



- Super Fast TCP NFS 

EASY TO USE AND SIMPLE TO INSTALL 

You get a super fast TCP/IP w/ NFS. And since it is 
a windows application you can install it in high 
memory, freeing up your valuable low memory for 
other uses. AIR includes TELNET/VT220, FTP, LPR, 
Ping and Sockets. It supports both 
ODI and NDIS drivers and popular PC 
X servers. We’ve even thrown in AIRMAIL, a Win¬ 
dows implementation of Internet Mail. And you get a 
full year of free support and free software updates. 

Windows available today. Version for NT available when NT ships. 



21 PCs 

* 162 ea 

I * PC '395, 20 add't '2,995 



Turn your PC into an 
X Terminal with XVision 


Whether you need to connect one, five, 20,50, 
or over 100 PC's to your Unix system, XVision 
and UniDirect make it easy. Get industry stan¬ 
dard X terminal access 

from your Windows MS-Windows 
System. Ask about * 

optional serial connections. Windows available 
today. Coming soon for NT. 


5 Pack'1695 
Evaluation s 49. NT Soon 


Smooth skating from Windows, 
DOS, Novell or NT to Unix 

For one low price, you can connect all your PCs at one 
location to your Unix system with ICE.TEN.PLUS. Ver¬ 
sions for both MS-DOS and MS-Windows are 
included in the same package. You get great 
Wyse terminal emulation and two-way file trans- ' 
oos/Win * er between DOS and Unix. You also get 
* Host Print which allows any DOS PC appli- * 

cation to print to any Unix printer on your host system. 
Ask about ICE.TCP for Novell to Unix connectivity. 

Connect to SCO Unix 1 


FAX: 714-707-3095 ▼ THE #1 NAME IN l\IT 



GET IT NOW! 


jiuM; 
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NTDirect is your source for NT and Windows to Unix connectivity 
products. Every product featured in this 
ad is backed by our exclusive 45 day 
100% Money Back Guarantee. Call us and 
ask for our latest list of NT software. We also 
distribute CodeBase, Chameleon, FTP, MKS Toolkit, 

Sun PC-NFS, Unix training videos and more. 

International 
Benelux 32-1061-1919 Singapore 657-484-511 Sweden 31-918-832 U.K. 788-552-005 
Fine Print: VISA, MasterCard, AmericanExpress, COD, Approved PO s. US orders shipped FedEx 
2nd Day. s 4.50 per order shipping & handling. COD is s 5 (US). International shipping as quoted. 
NTDirect. a UniDirect division, One Venture '150, Irvine, CA 92718.714-453-2999. 

Unix is a trademark of USL Windows NT is a trademark of Microsoft Corporation. All prices and specifications are subject to change without notice. 
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TrackDeck for Windows 
Because Graphs Make History. 



Graphs let you see what your program is doing 


There is no better way to debug, analyze performance or monitor a system. 

All you have to do is specify which variable to watch! TrackDeck will take care of monitoring, displaying and graphing it. 




Performance 

Analyze System 
Performance 



Pressure, Valve #1 



Pressure, Valve #2 

Track the status 
of hardware 



% Array Full 



Supposedly Fixed Value 


Catch bugs that 
take hours to 
appear 



Test Suites 


Display 
Automated 
Testing Results 


Are these two 
related? 



Add graphs to your user interface. ROYALTY-FREE 

Monitor any Windows 3.x program. Support for MS C++, VC++, VBasic and Access Basic, Borland C++, Pascal and Object Vision. 
TrackDeck is now selling at $129. For discounts, call: The Programmer's Connection: 800-336-1166 
Dashboard Software S 4 Louis Ave., Monsey, NY 10952 “S' 914-352-8071 


THIS IS HOW IT WORKS: 

TrackDeck has two parts. The Tracker DLL and the Dashboard Window. You insert a one-line command in your code for each 
variable you want to watch. Your program runs as normal while the Tracker monitors the value and informs the Dashboard 
Window whenever it changes. The Dashboard Window is a separate program you can bring up at any time that displays the 
value of your variable and updates it as soon as your program changes it. You can create any configuration of text, dials or his¬ 
tory graphs and save them to disk for later reuse or for giving to your customers using our royalty-free run-time version. 
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From 

the Editor 


The first chapter of the book Undocumented Windows, a paean to reverse engineering 
written by Andrew Schulman, David Maxey, and Matt Pietrek, is titled “This Was Not Supposed 
To Happen.” I recently found myself voicing the same sentiment When I started writing a book 
called WinHelp for Programmers and Technical Writers, I vowed I would not spend time trying 
to reverse-engineer the format of Windows help (.hip) files. So how is it that I just spent a few 
weeks working on precisely that? It's a long story. 

Microsoft receives regular requests via CompuServe to document the .hip File format and 
declines all of them with standard disclaimers about needing to be able to change the file 
format without affecting applications. However, the best arguments for keeping file formats 
proprietary don't apply to .hip files. These files aren't really operating system files — virtually 
all the data in the .hip file belongs to the programmer or technical writer who compiled the 
file, so why prevent people from making use of their own data at runtime? Another argument I 
view with skepticism is that Microsoft wants to be able to improve the file format without 
breaking any applications. The fact is, if Microsoft changes winhelp.exe so that it no longer 
accepts the current .hip file format, that would break every existing application that uses 
online help. No, it seems likely that Windows 3.2 will accept the current help file format, just as 
Windows 3.1 accepts the Windows 3.0 help file format The file format should be documented, 
which would stimulate third-party tools for creating better online help, which is in everyone's best 
interests. After all, Windows is still not beating the Macintosh out in any user-friendliness contests. 

Despite the great demand for the .hip file format, I don't are for reverse-engineering 
software, so I wasn't going to do it While the process itself is not impossible to enjoy, I just 
can't get excited about spending weeks to learn what I could learn in minutes if someone 
handed me documentation or a source code listing. Nevertheless, a few weeks ago I got talked 
into the job I never wanted. Peter Davis saw my article in Dr. Dobb's Journal (June 1993) about 
spying on the WinHelp() API function, and wrote to tell me that he had made some progress 
in decoding the .hip format. With some reluctance, I looked at what he had accomplished. It 
turned out that our areas of expertise were quite complementary, and during the next 48 
hours we made astounding progress in documenting the overall file format Since then, the 
going has gotten slower, but the clamor for a truly open help system is only growing, and it 
seems likely that we will have virtually complete documentation for .hip files within a month 
or two. This was not supposed to happen. 

All this leads me to the following conclusion: Microsoft is desperate for you to implement OLE 
v2.0 in your Windows application. Why do I say that? Because they are documenting file formats, 
and that's not something they do just because developers request it. The main beneficiary of OLE 
will be Microsoft, but only if it is widely adopted by other vendors, so they are looking for your 
support I'm no fan of OLE; I think it’s a monolithic hodgepodge (are you looking forward to 
learning hundreds more API functions?). One big difference between OLE vl.O and OLE v2.0 is that 
Microsoft is putting serious money and marketing muscle behind OLE v2.0. That will have an 
impact, regardless of whether developers love or hate OLE. For that reason, we’ve added an OLE 
v2.0 theme issue to our 1994 editorial calendar. If you are one of the OLE v2.0 pioneers (you 
know, the ones with arrows in your back), I hope you will keep some notes and consider taking 
time to share your hard-earned lessons with those of us who are hanging back. 

Ron Burk 

Editor 

CIS: 70302,2566-, BIX: rlburk-, Internet: ronb@rdpub.com ("... !uunet!rdpub!ronb“) 
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Phase O Has Everything You Need 

Lower CASE • Visual Development • Integrated RDBMS • Help Generator 
Extensible C or Pascal Code • Report Writer • Interactive Data Browser 



From start to finish, Phase3 is the fastest way to develop a complex 
Windows application. Whether you are writing custom programs or 
developing packages for resale, there’s no quicker or easier way to the 
finish than Phase3. Phase3 is a comprehensive Windows application 
development system with an integrated, relationally complete database 
Phase3 generates high performance, extensible C or Pascal programs. 
And Phase3’s context sensitive help and substantial on-line documen¬ 
tation make you productive on Day 1. 

Get a Quick Start with Automated Design 

Phase3’s Lower CASE front end automates data model design with 
Entity-Relationship modeling. Database creation, including appropriate 
indexes, is automatic. And you are prompted to choose the appropriate 
data integrity rules to be automatically enforced at runtime. 

Move to the Head of the Pack with a Robust, Integrated RDBMS 

The power of a Phase3 application lies in the relationally complete database supplied as a 
DLL. Access the database with built-in API routines. Automatic database restructuring, 
built-in database integrity enforcement, rollback recovery and transaction control are but 
several of the features that make Phase3 a database thoroughbred. 

Boost Your Performance with Visual Development 

Phase3 gives you complete interactive control over screen design. Place push buttons, 
radio buttons, dialog boxes, all the standard Windows screen items with ease. Create 
data entry screens quickly with Phase3’s populate function. Select appropriate 
Windows API commands from pick lists or write your own code. 

Make Final Adjustments in the Stretch 1 

To win you need to adjust — to changing user demands, to competitor pres- ■ 
sures. Phase3’s Hierarchy Chart is a visual tree of every screen, report, and ' 
code procedure in an application. It makes no difference whether it’s been 
several minutes or several years since you developed an application. Point and 
click and you’ve instantly accessed the code segment you want to modify. 






Cross the Finish with an Award 
Winning Application 

Context sensitive help is a hallmark of an 
award winning Windows application. 
Many developers stumble at the finish line 
because they’ve underestimated the effort 
required to create the help subsystem. 
Quickly create context sensitive help, 
including highlighted triggers that branch 
to related topics, with Phase3’s Help 
Generator. And cross the finish with core 
documentation automatically produced by 
Phase3’s database schema, Hierarchy 
Chart, and E-R Diagram. 

Call, Fax or Write to See How You 
Can Win with Phase3 

1 - 800 - 851-5650 

We’ll send you a complete information kit. 

Phase3 Software,Inc. 

Ventura, CA 

^ Phone:(805)641-9366 
Fax: (805)641-9083 


In Australia; 

Phase3 Software Pty. Ltd. 
Canberrra ACT 
Phone: (06) 285-4155 
Fax: (06) 285-4169 


Phase3™ is a trademark of Phase3 Software Pty. Ltd., Australia. 

All other product names referenced herein are trademarks of their respective companies. 
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Software Tools 


Extracting Strings 
from C Programs 

William F. Dudley, Jr. 
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Our small CAD software company decided to modify its application programs for 
users in non-English speaking countries. We were motivated not only by the desire 
to give non-English speaking users a program with messages in their own language, 
but also by our linker's refusal to link the application, due to an excessive amount of 
constant data (strings) in the source code. This article describes the tool we 
developed to assist in converting our program to an international application. 

Removing the Messages 

We decided to move almost all of the strings out of the source code and into a 
separate file. The application would read this file at runtime, stuffing the strings into 
memory. This not only solved the problem with the linker, it also allowed our 
foreign distributors to translate the messages file into their native languages, allow¬ 
ing our software to appear much friendlier to our foreign users. 

For a large application (40,000 lines) with many embedded messages, the 
prospect of removing all the messages struck us as tedious at best. Our solution was 
to write a message extractor, which reads a C source file and, for each message in 
the file, interactively asks the user if that message should be migrated to the mes¬ 
sage file. The message extractor remembers all the messages in the message file, so 
if a message is re-used, the extractor automatically fixes the source code to use only 
the one instance of the message. 

We added only one module to the application - one that finds the message file 
and reads it, allocating memory for each message as it goes. The application calls 
this routine at startup as part of the initialization process. 


The Message File 

The format we chose for the message file is a robust file format that a user can 
edit with a general-purpose text editor. A "record" holds each message, consisting of 
three parts: 

• A line with the message number and an identifying name (for debugging later 
on). The identifying name consists of the module name appended with the mes¬ 
sage number (e.g., fi leio_266). 

• The message itself, possibly on more than one line. 

• An EOT character (ctrl-D, '\004'). 


William Dudley is a consultant to AT&T Bell Labs Advanced Decision Support Systems, 
currently working on an Airline Schedule Planning System. He has a Masters in electri¬ 
cal engineering from Cornell University. When not programming for profit or fun, he 
can be found riding his Norton Commando (on nice days) or working on that or one 
of his other bikes (on less-nice days). He can be reached electronically at 71631,737 on 
CompuServe or dud@homxb.att.com on Usenet. 
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Introducing ProtoGen+. Visual tools with the most awesome 
workbench ever created lor Windows development. 


he future has arrived—a complete 
point-and-click, WYSIWYG 
workbench that lets you create 
dazzling applications without 
writing a line of code. 

Paint your 


Discover the ease and 
productivity of visual 
development! 


Visually 

develop 

screens 


Create a menu 
and connect 
screens & dialogs 


Test the applica¬ 
tion's screen (low in 
a live environment 


Instantly generate 
source code in 
Pascal, C or C++ 


screens. Design 
a menu and link 
screens togeth¬ 
er. Test the flow 
in a live environ¬ 
ment, and gen¬ 
erate code for 
ANSI C, C++ 
for OWL or MFC 
or Pascal with 
objects. It's that 
easy. 

And this 

open! ProtoGen+ 
will work with 
your database, 
compiler, 


libraries and extensions. Powerful 
add-on features, like SQLView offer 


&PWTbT131 3 


Bring your applications to life using the latest 
visual design tools! 


workbench access to multiple 
databases to develop client/server and 
xBase applications. Snap-in compo¬ 
nents make ProtoGen+ open to future 
development technologies—whatever 
they may be. 

ProtoGen+ is easy to learn, 
speeds your development cycle and 
protects your investment by generat¬ 
ing C.C++ and Pascal. We guarantee 
you’ll 
prototype 
and generate 
exciting 
applications 
faster than 
you ever 

Point-and-click to paint thought 
screens with bitmaps, | 

icons, tables, data valida- pOSSIDie. 

tion, custom colors, fonts, 

3D effects, visual tool¬ 
bars, status lines, balloon 
help, MDI and more! 


The most powerful, open set of 
Visual Development Tools ever! 
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The Visual Development Edge™ 

All products named are trademarks of their 
respective companies. ©1993 ProtoView Development 


Build win¬ 
dows, forms, 
dialog boxes, 
tool bars 

Output C, 
C++ and 
Pascal with 
Objects 

Create new 
designers! 
Source 
included 


Dialog 

Editor 


Menu 

Designer 



Code 

Gener¬ 

ator 


d 

ProtoView 

Screen 

Manager 



Custom 

Visual 

Designer 


Win- 

Control 

library 


Quickly 
create a 
menu using 
templates 

Data valida¬ 
tion, 3-D 
effects. MDI 
and more 

Rich library 
of visual 
control 
objects 




License our technology to 
create new code generators 


Fasten your seatbelt 
for ProtoGen+! 


Only 


(list price 
$395) 


$199 

1 - 800 - 231-8588 

Ask for Ext. 60 
In NJ, call (908) 329-8588 

ProtoGen+’s SQLView access to multiple 
databases is available at an additional price; 
ask about it when you call. 
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The following is a fragment of a message file. The ' \004' rep¬ 
resents real ''Os, which don’t print. 

fileio_132 

Warning, ROUTER couldn't open file %s for input 
1 \004 1 
fi1eio_133 

Error, ROUTER couldn't open tmp file %s 
ROUTER exiting to DOS 
•\004' 


The Message Extractor 

The message extractor ipakemsg.c in Listing 1) takes zero 
or more arguments on the command line. A single argument 
is interpreted as the name of the message text file; otherwise 
MAKEMSG prompts for it. If you supply two or more arguments, 
MAKEMSG takes the second through last arguments to be the 
names of C source files in which to look for messages. If you 
use wildcards for the C source files, they are expanded to the 
list of files matching the wildcard specification. If less than two 
arguments are used, MAKEMSG prompts for the name of a C 
source file. 

MAKEMSG next tries to open the message text file. If suc¬ 
cessful, it reads the file into alloc 'd space (just as the applica¬ 
tion will do at runtime). Each text record is stored in a struct 
consisting of the string and its index. This index will facilitate a 
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-Column & row split windows Windows SDK , „ $, 
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-Column & row split windows y’Vcl 
-Multiple row & column selections 
-Check boxes/ radio buttons/ bitmaps/ 
editable & eomhobox column 
-Input Validation 
-Color customization 


■ Ribbon / Icon Bar 

-3D items w/ color customization 
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Listing 1 makemsg.c — Source code for makemsg 


/* for "Preparing a C application for non-English speaking users" 

* William F. Dudley Jr. 

* 

* Usage: makemsg msg_file c_file c_file2 . . . 

* Example: makemsg msg_file ,./*.c 

* 

* Note: all the hooks are in place for sorting the strings for 

* faster searching. We are doing linear search for now, but if 

* speed becomes a problem, we can wire it up. 

*/ 

♦include <stdio.h> 

♦include <string.h> 

♦include <dir.h> 

♦include <errno.h> 

♦if _TURBOC_ 

♦include <mem.h> 

♦include <alloc.h> 

♦elif USC 

♦include <memory.h> 

♦include <malloc.h> 

♦define MAXPATH 80 
♦define MAXDRIVE 3 
♦define MAXDIR 66 
♦define MAXFILE 9 
♦define HAXEXT 5 
♦define EXTENSION 0x02 
♦define FILENAME 0x04 
♦define DIRECTORY 0x08 
♦define DRIVE 0x10 

int fnsplit (char *, char *, char *, char *, char *); 
void fnmerge (char *, char *, char *, char *, char *); 

♦endif 

♦define FALSE 0 
♦define TRUE 1 
♦define MAIN 1 
♦include "makemsg.h" 

int loadmsgs (unsigned *, struct msg *, FILE *, int); 

FILE *xsrc, *xold, *xnew, *xmsg, *xhdr; 

char qsrc[MAXPATH], qold[MAXPATH], qnew[MAXPATH], qmsg[100]; 
char p[100], q[100], pout[I00], psav[100]; 

int jmsg, jeomment, jquote, kquote, jprintf, jif; 
int i, j, k, 1, m, n; 

main (arge, argv) 
int arge; 
char “argv; 

{ 

int error = 0; 
unsigned int ent; 

char qdisk[MAXDRIVE], qpath[MAXDIR]. qfname[MAXFILE], qext[MAXEXT]; 
char *tok; 
int exists; 

int pathbits, files, argent; 

/* Open message file and find highest number. */ 
if (arge > 1) 

strepy (qmsg, argv[l]); 
else { 

printf ("Msg file -> "); 
scanf ("%s", qmsg); 

} 

xmsg = fopen (qmsg, "r"); 
if (xmsg == NULL) { 

printf ("No message file %s found.\n", qmsg); 
exit (9); 

} 

/* read existing message file into memory */ 

ent = sizeof (txt)/sizeof (struct msg); 

error = loadmsgs (&cnt, txt, xmsg, 1); 

if (error) exit (error); 

jmsg = ent; 

fclose (xmsg); 

xmsg = fopen (qmsg, "a"); 
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Listing 1 continued 


if (argc > 2) { 

strcpy (qsrc, argv[2]); 
files = argc - 2; 

} 

else ( 

printf (“Source file -> "); 
scanf (“%s\ qsrc); 
files = 1; 

) 

for(argcnt = 0 ; argent < files ; argcnt++) ( 

/* first sre file is already in qsrc, strcpy not needed */ 
/* subsequent sre files need to be gotten, however */ 
if (argent) strcpy (qsrc, argv[argcnt+2]); 
xsrc = fopen (qsrc, "r"); 
if (xsrc -- NULL) { 

printf (“No source file %s found.\n", qsrc); 
exit (9); 

) 


/* strip off disk and path */ 

pathbits = fnsplit (qsrc, qdisk, qpath, qfname, qext); 
fnmerge (qold, NULL, NULL, qfname, qext); 

/* make qnew have no drive or directory, new files made in CWD */ 
fnmerge (qnew, NULL, NULL, qfname, qext); 

/* if source is not in another directory, 

* append 'n' & 'o' to file names */ 

if (!(pathbits & (DIRECTORY | DRIVE))) ( 
streat (qold, "o“); 
streat (qnew, "n“); 

) 

xnew = fopen (qnew, "w“); 


jeomment = FALSE; jprintf = FALSE; jif = FALSE; 
while (TRUE) ( 

fgets (q, 128, xsrc); 
if (feof (xsrc)) break; 


jquote = 0; 
kquote = 0; 
if (q[0] != '#') ( 

for (j = 0; q[j]; j++) ( 

if (!strncmp(&q[j], "printf", 6)) jprintf = TRUE; 
if (!strncmp(&q[j], "#if", 3)) jif ■ TRUE; 

if (!strncmp(&q[j], "lendif", 6)) jif * FALSE; 


if (q[j] *■ 7' && q[j+l] -- '*') jeomment = TRUE; 
if (q[j] ** '*' && q[j+l] ** 7') jeomment = FALSE; 


if (jprintf *■ TRUE && jeomment "= FALSE && 
jif == FALSE it, q[j] == *\"') 

( 

if (jquote == 0) jquote = j; 

else if (kquote ** 0) kquote * j; 

} 


} 

if (jquote && kquote) { 

/* extract the string, save it in psav[], */ 

/* expand it into pout[] */ 

k = 0; 

for (j - jquote+1; j < kquote; j++) ( psav[k] = q[j]; k++; } 

psav[k] * 0; 

for (j * 0, tok » psav; *tok ; tok++) { 
if (*tok I* 1 \\') 
pout[j++] » *tok; 
else { 

switch (tok[1]) { 

case 'n' :/* we found "\n" */ 
pout[j++] ■ '\n 1 ; 
break; 
case 1 1 1 : 

pout[j++] ■ '\t'; 
break; 
case 1 v 1 : 

pout[j++] = '\v'; 
break; 
case ' b 1 : 
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Listing 1 continued 


pout[j++] = ' \b ’; 
break; 
case 1 r 1 : 

pout[j++] * '\r’; 
break; 
case 'f‘ : 

pout[j++] = • \f 1 ; 
break; 

case 'O' : case '1' : case '2' : case '3' ; 
case '4' : case '5' : case '6' : case '7' : 
i=tok[3]-'O'+(tok[2]-'0')*8+(tok [1] -'0')*8; 
tok += 2; 

pout[j++] - (char)i; 
break; 
case '\\' : 

pout[j++] * 'W; 
break; 
default : 

tok-; /* don't skip 2 chars */ 
break; 

) 

tok++; /* because we prob. found "\n" */ 

) 

} 

pout[j] - '\0'; 
if (kquote-jquote < 3) { 
fprintf (xnew, “%s“, q); 

} 

else { 

exists - -1; 

/* is string found in existing message file ? */ 
for(j = 0 ; j <= jmsg ; j++) { 

if(!strcmp(pout, txt[j].s)) break; 

} 

/* does string exists in message file already ? */ 
if (j != jmsg+1) exists - txt[j].index; 
if (exists >= 0) 

printf (“%s: string found in msg file, #%d: Fixing.\n", qsrc, exists); 
else ( 

/* does user want to move string out of source file ? */ 

Query: 

printf ("\n%s\n", q); 

printf (”\t\tLeave it or Fix it? “); scanf C'%s", p); 
if(P[0] -- '1' || p[0] == 'L') { 
fprintf (xnew, "%s“, q); 
continue; 

) 

else if (p[0] 1= 'f' && p[0] 1= 'F') 
goto Query; 


if (exists < 0) ( 

/* then we haven't seen this string before */ 
jmsg++; /* Bump message counter. */ 

if (jmsg > MAX_MSG$) ( 

fprintf (stderr, "too many strings\n"); 
exit (ENOMEM); 

} 

/* now store message in bufr array */ 
j « strlen (pout); 
txt[jmsg].s " calloc (j+1, 1); 
if (txt[jmsg].s ■* NULL) ( 

fprintf(stderr,“can't alloc more memory, line %u\n“, msg); 
exit (ENOMEM); 

) 

strcpy (txtfjmsg].s, pout); 
txt[jmsg].index * jmsg; 
exists * jmsg; 

fprintf (xmsg, “%d %s_%03d\n", jmsg, qfname, jmsg); 
fprintf (xmsg, “%s\n\004\n”, pout); 

) 

/* Print the line without quoted string. */ 
strncpy(p, q, jquote); k * jquote; 
k +* sprintf (p+k, "txt[%d]“, exists); 
for (j = kquote+1; q[j]; j++) ( p[k] = q[j]; k++; ) 

p[k] * ' \0'; 

fprintf (xnew, "%s", p); 

/* And put a comment into the code with the string. */ 


planned enhancement, sorting the 
strings so that a binary search can be 
used instead of the current linear one. 
So far, this revision has proven unneces¬ 
sary, since a linear search of a few 
hundred strings doesn't take very long. 

Next MAKEMSG runs through a loop 
for each of the C source files specified 
on the command line. If the source file 
name has a directory component to its 
name (i.e., resides in a directory other 
than the current one), MAKEMSG reads 
the source file, but writes a new source 
file of the same name in the current 
directory. If the source file is in the cur¬ 
rent directory, MAKEMSG creates a new 
source file with name XXXXn (e.g., 
eclipse.c becomes eclipse.cn). If the 
text extraction goes without problems, 
then the old source file is renamed to 
XXXXo (e.g., eclipse.co) and the XXXXn 
file gets the original name of the old 
source file. 

The next part of the loop decides 
what constitutes a string and asks the 
user to "Fix it or Leave it?" These rules 
you will most likely want to customize 
for your application. Our rules are fairly 
simple: the string can’t be bracketed by 
UfHtendif (so as to ignore most debug 
printfs), cannot be in a comment, and 
must start on a line with a “printf' 
(which encompasses sprintf, fprintf, 
and vsprintf. 

Once MAKEMSG detects a candidate 
string, it searches the existing message 
database for a copy of it. If one is 
found, the source file is automatically 
fixed to use the existing stored string. If 
the string is not in the database, the 
user is asked to “Fix it or Leave it?” If 
“Fix," MAKEMSG adds the string to the 
message base, appends the new text 
record to the end of the message file, 
and fixes the source file to use the 
proper entry in the (future) txt[] array. 
If “Leave," MAKEMSG simply copies the 
source file to the new file and cycles 
back to the top of the while loop. 

The Message Loader Module 

The message loader module, shown 
in Listing 2, searches down the DOS 
PA TH for the message File. After success¬ 
fully opening the file, the module reads 
each record, checks that its number 
agrees with the loop counter (the file 
corruption test), allocates the memory 
for the string, copies the string to that 
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memory location, and sets the pointer in the txt[] array to 
point to the string. 

The loader returns to the caller the number of the last 
message read, so that if the integrity check fails, a message is 
printed on the console telling the user at what line in the txt 
file the error occurred. 

Creating Messages 

Once you have decided to make your messages translatable 
to other languages, you have new restrictions on how you may 
generate your messages. For example, the printf construct 

intf("There %s %d via%s in this job.\n", 

(via_countl) ? "are” : "is", via_count, 
(via_countl) ? "s" : " " ); 

which reports the number of items in a job, will not translate 
well into other languages. You will be lucky if the target lan¬ 
guage makes plurals as English does. You should instead have 
two messages - one for the singular, and one for the plural. 

In general, when writing messages, don’t do anything 
tricky using English grammar, spelling, or parts of speech. 

Another consideration is the size of the message buffers. 
Our experience suggests that if you plan on producing a Ger¬ 
man version of your program, make sure that the buffers into 
which you copy your messages (using sprintfO or strcatf), 
for example) are at least twice as long as needed by the 
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constructed tools for quick integration of images into 
any application, and built a toolkit with a reputation for 
speed! Call for a free evaluation diskette to see for 
yourself. 

LEAD Technologies, Inc. 
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Listing 1 continued 


m = 60-strlen(psav); 

while (m > 7) ( fprintf (xnew, “\t”); m -= 8; ) 
while (m > 0) ( fprintf (xnew, " "); m -» 1; ) 
fprintf (xnew, "/* » %s « */\n", psav); 

I 

1 

else fprintf (xnew, "%s", q); 

I 

fclose (xsrc); 
fclose (xnew); 

if (Kpathbits & (DIRECTORY | DRIVE))) ( 
unlink (qold); 
rename (qsrc, qold); 
rename (qnew, qsrc); 

I 

1 

fclose (xmsg); 
jmsg++; 

xhdr ■ fopen ("menuload.h", “w"); 
fprintf (xhdr, "char *txt[%d];\n", jmsg); 
fclose (xhdr); 

exit (0); 

1 

#ifdef MSC 

/* this function is in the Turbo-C library *1 

int fnsplit (path, disk, dir, name, ext) 
char *path, "disk, ‘dir, *name, *ext; 

f 

char bdisk[MAXDRIVE], bdirfMAXDIR], bnamefHAXFILE], bextfMAXEXT]; 
char ‘cpl, *cp2; 
register int i; 
int result; 

i = 0; 

cpl = strchr(path, ':'); 

if (cpl == NULL) cpl - &path[-l]; 

else for( ; &path[i] <= cpl ; i++) bdisk[i] = path[i]; 

bdisk[i] - '\0'; 

cp2 - strrchr(path, '\\'); 

i ■ 0; 

if (cp2 == NULL) cp2 = strrchr(path, '/'); 
if (cp2 == NULL) cp2 - cpl; 

else for( cpl++ ; cpl <= cp2 ; i++, cpl++) bdir[i] ‘ *cpl; 
bdi r [i ] = 1 \0 1 ; 

for( i = 0, cp2++ ; ((*cp2)&&(i < 8)S&(‘cp2!='.')) ; i++, cp2++) ( 
bname[i] * *cp2; 

I 

bname[i] * '\0'; 

for( i = 0 ; {(*cp2)W(i < 4)) ; i++, cp2++) ( 
bext[i] = *cp2; 

) 

bext[i] = ‘ \0 1 ; 

if (disk!=NULL) strcpy(disk, bdisk); 
if (dir!=NULL) strcpy(dir, bdir); 
if (name!=NULL) strcpy(name, bname); 
if (ext!=NULL) strcpy(ext, bext); 
result - (strlen(bdisk)) ? DRIVE : 0 ; 
result += (strlen(bdir)) ? DIRECTORY : 0 ; 
result +* (strlen(bname)) ? FILENAME : 0 ; 
result += (strlen(bext)) ? EXTENSION : 0 ; 
return(result); 


void fnmerge (path, disk, dir, name, ext) 
char *path, ‘disk, *dir, ‘name, *ext; 

( 

sprintf (path, "%s%s%s%s%s“, path, disk, dir, name, ext); 

) 

fendif 

/* End of File */ 
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Listing 2 txtload.c - Module to load message text into memory 

/* compiles with MSC 4.0, TCC 2.0, or Watcom 386 8.0 
* makefile sets MSC true when using MSC 4.0 compiler. 

♦define MENBUFLEN 256 

*/ 

/* load messages into calloc'd array. 

* typical usage: 

♦include <dos.h> 

unsigned cnt; 

♦include <errno.h> 

int error, line; 

♦include <math.h> 

struct msg *txt[139]; 

♦include <stdio.h> 

FILE ‘menufile; 

♦include <time.h> 

menufile = fopen("R0UTEMSG.TXT" 1 "r"); 

♦include <string.h> 

cnt * sizeof (txt)/sizeof (char *); 

♦include <signal.h> 

error = loadmsgs (cnt, txt, menufile, load, &line); 

♦include <stdlib.h> 

if (error) ( 

♦if TURB0C 

printf ("Error at line %d in R0UTEMSG.TXT.W, line); 

♦include <mem.h> 

exit (EF0RMAT); 

♦include <alloc.h> 

) 

♦include <fcntl.h> 

* return number of messages in *cnt. 

♦include <sys\stat.h> 

* return error condition or 0 if OK. 

♦include <io.h> 

*/ 

♦elif MSC 

/* ***** LOADMSGS ***** */ 

linclude <memory.h> 

int loadmsgs (cnt, arp, mfile, lod) 

♦include <malloc.h> 

unsigned int *cnt; 

linclude <fcntl.h> 

struct msg arp[]; 

♦include <sys\types.h> 

FILE *mfi 1 e; 

linclude <sys\stat.h> 

int lod; 

linclude <io.h> 

{ 

♦endif 

int j, k, row; 
char lbuf[MENBUFLEN]; 

♦define MAIN 0 

char bufr[MENBUFLEN]; 

linclude "makemsg.h" 

int error=0; 
int col=-l; 

char nothing[] ■ 

for (k = 0 ; k < *cnt ; k++ ) { 

if (NULL — fgets (lbuf, 128, mfile)) ( *cnt = k-1; break; } 
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number . Otherwise it’s as quiet as an 
eagle on the wind. Without your 
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And you can use MemCheck with C++ 
to keep your C++ apps in tip-top shape. 

Easy to use 

Developing reliable software is 
challenging for the best of us. Using 
MemCheck brings big payoffs for novice 
and expert alike in quality and time 
savings. But you be the judge—\our 
satisfaction is guaranteed. Call 1 -80#- 
933-3284 (1-800-WE-DEBUG) and|i| 
take the fastest . easiest approach#} 
stomping the whoppers of C bugs. 


MemCheck comes ready to run 
be sure to specify cmnpifer xyf 
d platforml 
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DOS $139 

WINDOWS $17 9 $99 W 

MACINTOSH ±479 $99 fZttt 

SPECIAL BUNDLES! 

DOS MASTERS PACK $199 

far Microsoft CjfND Borland C... save $80 

WINDOWS GURU PACK $159 

for Microsoft C AND Borland C 

PC POWER PACK $ 199 

any D()S version + any Windows version 


1 M’RRTS' C'.ORNKR: 

“MemCheck is worth its 
weight in gold. ” 

— David Thielen, author of ‘NO BUGS: 
Delivering Error-Free Code in C and C++’ 

1 - 800 - 
WE-DEBUG 

tiri WE USE AND SHIP QUALITY 
*T&? RECYCLED MATERIALS. 


1-800-WE-DEBUG • Inununiomtl (313)996-2944 • fax Urns (313) 996-2953 & (313) 747-8519 
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legwork. 


How well your new Windows IMF 
applications perform in 
market has a lot 
to do with how quickly 
you get them there. 
Digital’s Alpha AXP Software 
Developers’ Program for Windows NT 
saves some of the steps and irons out 
the complexities of developing or porting 
apps for Windows NT. 
You get Windows NT programming 
expertise for all aspects of development. 
More than just traditional documentation 
and reference materials, 
there’s a toll-free technical hotline, 
access to Alpha AXP'“ migration centers 
worldwide and Windows NT training 
specifically for 


64-bit AXP™ 
World’s fastest 
microprocessor 


developers. Beyond 
migration there’s 
marketing support, 
including special 
promotions and co-op opportunities 
with the world’s premier supplier 
of Windows systems, services 
and solutions. 
Yes, you can get your Windows NT 
on Alpha AXP apps to market quickly 
and yes, you can do it without a 


staggering amount of overtime. 
Digital has helped hundreds of 
developers, both independent and 
corporate, streamline the process. 

Can we help you? 


Digital ’s Alpha AXP Software Developers' 
Program for Windows NT: 

Migration technical support, including toll-free 
hotline, documentation and reference materials 


axp 


Access to Alpha AXP 
migration centers worldwide 


Joint marketing programs and special promotions 

A Windows NT worldwide training curriculum for 
developers and system managers 

For more information about porting to 
Windows NT on the world's most powerful PC, 
contact Digital via the Internet 
at alpha @aimhi. enet. dec. com, 
or call.1.800.332.4403 
Please reference code BHS 


Windows NT on the 
world’s most powerful PC. 
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Listing 2 continued 


row * atoi(lbuf); 

if (k!=row) { error++; break; } 

if (k!=(co!+l)) ( error++; break; } 

col * row; /* save row for monotonicity check */ 

memset (bufr.O.MENBUFLEN); 

if (NULL *• fgets (lbuf, 128, mfile)) { error++; break; ) 
while(lbuf[0] != 4) ( 

if(bufr[0]) strcat (bufr, “\n“); 
if (lbuf[0] ** '\n') strcat (bufr, “\n"); 
else ( 

lbuf[strlen (lbuf)-l] = '\000'; 
strcat (bufr, lbuf); 

) 

if (NULL == fgets (lbuf, 128, mfile)) ( error++; break; ) 

) 

/* now store message in bufr away */ 
if (lod) ( 

j = strlen (bufr); 
arp[k].s * calloc (j+1, 1); 
if(arp[k].s — NULL) ( 

fprintf(stderr,"can't alloc more memory, line %u\n",k); 
return(ENOMEM); 

) 

strcpy (arp[k].s, bufr); 

) 

else arp[k].s • &nothing[0]; 
arp[k].index - k; 

} 

return (error); 

1 

/* End of File */ 


r 
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reports. 
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on time. 
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English versions. (The German word for “bus," as in "electrical 
bus,” is “verbindungsbundel.”) 

Summary 

If you sell your programs to non-English speaking users, 
you should address the problem of communicating in their 
language, if you haven't already done so. The module and 
program presented here should help you to modify your ap¬ 
plication so that it can load its messages from an external file, 
which can then be translated into other languages. 

The code is designed to compile under three compilers: 
MSC 4.0, TCC 2.0, and Watcom 386 8.0. This work does not 
consider the problems that arise with languages which need 
16-bit characters, such as Chinese or Japanese. □ 


Listing 3 makemsg.h — makemsg header file 


/* for "Preparing a C application for non-English 

* speaking users" 

* William F. Dudley Jr. 

*/ 


♦define MAX MSGS 10000 
#if 'MAIN 


extern 

♦endif 

struct msg ( 

char *s; 
unsigned index; 
) txt[ 

#if MAIN 


fendif 


MAXMSGS 

]; 


/* End of File */ 


Listing 4 

makemsg makefile 

♦ $* is the target w/o suffix 

MAKE TMP = $(TMP) 

OBJS = makemsg.obj txtload.obj setargv.obj 

CC * tcc 


# -0 optimize TCC for size 

# set D—v for TDebug 

#D=-0 


D=-v 


TCC OPTS = -me 

$(D) 

CC OPTS = $(TCC OPTS) 

ASM = tasm 


.SUFFIXES: .exe 

.obj .c .asm 

■AFTER: 


9 beep 


•c.obj: 


tcc $(CC_0PTS) -c $*.c 

.asm.obj: 


$(ASM) /mx $*; 

makemsg.exe: 

$(0BJS) 

$(CC) $(CC_OPTS) -e$*.exe $(0BJS) setargv.obj 

makemsg.obj: 

makemsg.c makemsg.h 

txtload.obj: 

txtload.c makemsg.h 
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Software Tools 




Simplified Windows 
User Interfaces 



AW 

AM 

/VW 

AW 



Al Williams 


When faced with a Windows programming task, most programmers automat¬ 
ically think of creating windows, WM_PAINT handlers, and GDI calls — in short, all the 
trappings of a full-blown Windows application. In fact, however, you can simplify 
many programs by using built-in Windows tools like menus, dialogs, and control 
windows. Some programs don't even require a window —you can launch dialog 
boxes or call the MessageBoxf) function directly from your UinMainf) routine. 

In this article, I show you how to create a simple yet powerful program launcher 
using only menus. The application, wmenu.exe, has a window with no client area 
(and no WM_PAINT handler). It creates its menu dynamically, based on a configuration 
file you supply, wmenu.exe is especially suited for developers, since it lets you enter 
command lines and simulates a current working directory for your programs. 

About WMENU 

Figure 1 shows wmenu.exe in operation. The File menu is always present. The 
other menu items are defined by a configuration file such as that shown in 
wmenu.dat (Listing 1). The configuration file has a simple format. The first line con¬ 
tains the title that WMENU displays in its caption bar. The next line, which must not 
contain a colon, defines the first main menu item. Subsequent lines with colons 
define items for the first menu item: the text before the colon appears in the menu; 
text after the colon determines the command line WMENU executes for that choice. 
If the command line begins with an asterisk, WMENU will allow you to edit the 
command line before execution. The asterisk doesn’t become part of the command. 

The next line without a colon defines another main menu option. Subsequent 
lines with colons define elements for the menu. You can specify any legal DOS or 
Windows program for the command line. If you want to execute a .com or .bat file, 
you must explicitly indicate the extension — by default, WMENU searches only for 
. exe files. If the application is not in your path, you will need to specify a full path 
name in the configuration file. 


Al williams is the author of several programming books, including DOS and Windows 
Protected Mode and Commando Windows Programming (both from Addison-Wesley). 
You can reach him on CompuServe at 72010,3574. 
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Listing 1 wmenu.dat — Sample menu definitions 


Listing 2 continued 

for wmenu.exe 



Development Menu 


"Can't run multiple copies of this program". 

AProgramming 


"This program requires protected mode", 
l. 

&Make:make 

SBorland C:*bcc -v 


/* Main window function */ 

&RC:*rc 


int PASCAL WinMain (HANDLE hlnst, HANDLE prev. 

Resource &Workshop:d:\borlandc\bin\workshop 

ATurbo debugger:*td 


LPSTR cmdline, int show) 

{ 

AWindows debug:tdw 


MSG msg; 

AText Tools 


char cwd[81]; 

&Editor : Notepad 

&Word :f:\winword\winword 


if (linit (hlnst, prev, show)) /* set up app */ 
return FALSE; 

topmenu = GetMenu (topwindow); /* Get handle for menu */ 

AGP Tools 


if (Ifile read (cmdline)) /* process file */ 

ACalculator :calc 


return FALSE; 

ASolitare:sol 


/* Get directory from profile */ 

ADOS Tools 


GetProfileString ("WMENU", "CurrentDirectory", "\\“, 

&Edwin: ‘edwin.com 


cwd, sizeof ( cwd) ) ; 

&4dos : c : \4dos\4dos.com 


/* Set directory */ 

ASpecial 


if (CHDIR (cwd)) 

ACommand Line:* 


MessageBox (topwindow, "Invalid working directory". 



"Warning", MB OK | MB ICONSTOP); 

}; 



Listing 2 wmenu.c — Main source for wmenu.exe 


while (GetMessage (&msg, NULL, NULL. NULL)) 

{ 


TranslateMessage (&msg); 

DispatchMessage (&msg); 


/* WMENU application launcher -- A1 Williams 


/ 

return (msg.wParam); 

} 

* To compile: cc wmenu.c 
*/ 


/* Start up stuff */ 

#include <windows.h> 


int init (HANDLE hlnst, HANDLE prev, int show) 

linclude <mmsystem.h> 

#include <stdio.h> 


{ 

if (!prev) 

linclude <stdlib.h> 


if (linit app (hlnst)) 

linclude <string.h> 


return FALSE; 

linclude <ctype.h> 


if (linit inst (hlnst, show)) 

linclude <stdarg.h> 


return FALSE; 

#if defined ( BORIANDC ) || defined! ZTC ) 


return TRUE; 

linclude <dir.h> 

Idefine CHDIR chdir 

Idefine STRDUP strdup 


) 

/* Create window class here */ 

Idefine GETCWD getcwd 


BOOL init app (HANDLE hlnstance) 

lelse 


{ 

linclude <direct.h> 


WNDCLASS wc; 

Idefine CHDIR chdir 


wc.style = NULL; 

Idefine STRDUP strdup 


wc.lpfnWndProc = (void far *) win proc; 

Idefine GETCWD getcwd 


wc.cbClsExtra = 0; 

lendif 


wc.cbWndExtra = 0; 

linclude "wmenu.h" 


wc.hlnstance = hlnstance; 

wc.hlcon = Loadlcon (NULL, IDI APPLICATION); 

HANDLE hlnst; /* current instance */ 


wc.hCursor = LoadCursor (NULL, IDC ARROW); 

HWND topwindow; /* main window */ 


wc.hbrBackground » GetStockObject (WHITE BRUSH); 

HMENU topmenu; /* Main menu */ 


wc.lpszMenuName = "WMENU"; 

char string[1025]; /* GP string */ 


wc.lpszClassName = "WMENU Class"; 

char *menuline$[100];/* array of menu items */ 
char *execerr[] = /* WinExec errors */ 


return (RegisterClass (Awe)); 

} 

l 

"Out of memory". 


/* Create window here */ 

NULL, 


BOOL init inst (HANDLE hlnstance, int nCmdShow) 

“File not found", 

"Path not found". 


( 

HWND hWnd; 

NULL, 


/* Save the instance handle in global variable */ 

“Can't dynamically link task". 


hlnst = hlnstance; 

"Library requires separate data segments". 


/* Create the main window */ 

NULL, 


topwindow = hWnd - CreateWindow (“WMENU Class", "WMENU", 

NULL, 


WS OVERLAPPED|WS CAPTION|WS SYSMENU|WS MINIMIZEBOX, 

NULL, 


0, 0, GetSystemMetrics (SM CXFULLSCREEN), 

"Incorrect Windows version". 


GetSystemMetrics (SM CYMENU) + 

"Bad EXE format". 


GetSystemMetrics (SM CYCAPTION) + 2, NULL, NULL, 

“OS/2 application". 


hlnstance, NULL); 

"DOS 4.0 application". 


if (IhWnd) 

"Unknown EXE type", 

"Incorrect Windows version". 


return FALSE; 

"Can't run multiple copies of this program". 


ShowWindow (hWnd, nCmdShow); 
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WMENU interprets the ampersand 
(“&”) just as the resource compiler does. 
The character after the ampersand be¬ 
comes the menu’s keyboard equivalent. 
For example: 

&Run foo:foo 

defines a menu item "Run foo” (the R 
will be underlined in the menu). If you 
press Alt-R while this choice is visible, 
the program called foo will run. 

You can edit an entire command 
line before execution if the line begins 
with an asterisk. You can exploit this to 
make a menu choice act as a manual 
application launcher. Just place a line in 
your configuration file like this: 

Run any command:* 

When you choose this command, 
WMENU will allow you to edit the blank 
command line. Enter anything you like, 
and WMENU will execute it. 

Developers and other advanced 
users often work in several different 
directories during the same Windows 
session. WMENU tracks a pseudo work¬ 
ing directory. You can select a current 
directory from the File menu. This will 
be the working directory for all 
programs launched from WMENU. 
WMENU stores the directory in WIN. INI 
so that you won’t need to set it every 
time you start WMENU — the last 
change you made will affect new 
copies of WMENU. You usually supply 
the name of a definition file as an argu¬ 
ment to WMENU. If you fail to provide 
one, WMENU will look for the file 
wmenu.dat in the current directory. 


Implementation 

The WMENU application consists of a 
few short files, wmenu.c (Listing 2) and 
wmenu.h (Listing 3) contain the main 
code, wmenu.rc (Listing 4) defines 
WMENU's initial menu and the dialog 
template for the get_input() function. 


Windows Help Magician 2 


The fast & easy way to develop Hypertext 
Help Files for Windows just got better! 
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Create, edit, and lest help quickly 
in an integrated environment! 


Some original features 

□ Built-in full-featured editor 

□ Create jumps and popups 

□ Create multiple hot spots 

□ Include bitmaps 

□ Create bulleted or numbered lists 

□ Create browse sequences 

□ Use various font styles and colors 

□ Test help files instantly : 

□ Quickly writes RTF files 

□ Imports MS Word’s RTF files 

□ Extensive error & syntax checking 

□ Works with any Windows language 
including Visual BASIC and C 


No Windows application is 
complete without a profes¬ 
sional help system. The 
Windows Help Magician 
greatly reduces the compli¬ 
cated task of creating 
hypertext help to a simple 
process of point and click. 
That’s why Windows 
Magazine gave the Help 
Magician an "A" for 
creating help files 
interactively. 

Version 2.0 features 

□ No memory limitations 

□ Secondary windows 

□ Non-scrolling regions 

□ Set background colors 

□ Advanced paragraph 
formatting 

□ Full macro support 

□ Jump to other help files 

□ Custom copyright and icon 

□ Help window sizing and 
positioning 

□ Built-in spell checker 

□ Writes #define files 


Our competitors require Microsoft Word and use a series of 
macros, a slow process. The Help Magician is a fast, 
full-blown Windows application. Our competitors charge 
$150/yr for tech support; we don’t. Simply put, the Help 
Magician is the best help authoring tool money can buy! 
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Listing 2 continued 


UpdateWindow (hWnd); 
return (TRUE); 

1 

long FAR PASCAL _export win_proc (HWND hWnd, WORD message, 

WORD wParam, LONG IParam) 

( 

switch (message) 

{ 

/* menu commands .... */ 
case WM_COMMAND: 
menu (hWnd, wParam); 
break; 

/* End of the road... */ 
case WM_DE$TR0Y: 

PostQuitMessage (0); 
break; 

default: 

return (DefWindowProc (hWnd, message, 

wParam, IParam)); 

} 

return NULL; 

) 

/* Menu handling code */ 

void menu (HWND hWnd, int wParam) 

( 

char cmd[512]; 
char ‘line, *cd; 
int stat; 

/* If wParam>=200 then this is a user menu item */ 


fractal 



Hdding images to your Windows appli¬ 
cations? Avoid storage problems with 
fractal image compression, the technology 
that inspired PC Magazine to declare 
"The advantages of fractal compression 
are unmatched." 

This technology is now 
available to Windows 3.x 
developers in POEM 
ColorBox III, which pro¬ 
vides DLLs for: 

• Ultra-high compression; 

• Resolution independent 


images; 

• Background < 


l compres¬ 
sion; and 
• FTC-Ill coprocessor support 

For database, multimedia, archiving or 
other applications, ColorBox III is compre¬ 
hensive, easy-to-use and at $995, sup- 
ingly affordable. 

Call today for more information. Learn 
why ColorBox III can solve your image 
storage problems. 


* 


Iterated Systems, Inc. 

5550-A Peachtree Pkwy ,Suite 650 
Norcross, GA 30092 
1-800-4FRACTL • Fax: (404)840-0806 
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if (wParam »■ 200) 

( 

int offset = 0; 

/* adjust to 0 */ 

wParam -■ 200; 

/* skip space */ 

while (isspace (menulines[wParam][offset])) 
offset++; 

/* If edit requested */ 

if (menulines[wParam][offset] == '*') 

f 

/* skip asterisk */ 

offset +■ 1; 

/* skip space again */ 

while (isspace (menulines[wParam][offset])) 
offset++; 

/* get line */ 

strcpy (cmd, menulines[wParam] + offset); 

/* edit it */ 

line = get_input (cmd, sizeof (cmd), 

"Edit command line", “Current directory=%s", 
cd = GETCWD (NULL, 128)); 

free (cd); 

/* if line is NULL, then cancel */ 
if (line) 

/* otherwise run command */ 

stat = WinExec (line, SW_SH0W); 

} 

else 

/* No editing, just run command */ 

stat = WinExec (menulines[wParam] + offset, SW_SH0W); 
if (stat < 32) 

{ 

/* ERROR! */ 

if (stat > sizeof (execerr) / sizeof (char *) 

|| execerr[stat] ** NULL) 
line = "Unknown error"; 
el se 

line * execerr[stat]; 

MessageBox (topwindow, line, NULL, 

MB_0K | MB IC0NST0P); 

1 

return; 

) 

/* "Normal" menu code (from file menu) */ 
switch (wParam) 

( 

case IDM_AB0UT: 

MessageBox (topwindow, 

"WMENU Version 1.0 by A1 Williams", 
“About", MB_0K | MBJC0NINF0RMATI0N); 

return; 
case IDM_DIR: 

/* Change working directory */ 

GETCWD (cmd, sizeof (cmd)); 

line * get_input (cmd, sizeof (cmd), 

"Enter working directory", “Current directory=%s", 
cd - GETCWD (NULL, 128)); 

if (line) 

{ 

if (CHDIR (line)) 

{ 

MessageBox (NULL, "Bad directory”, 

NULL, MB_0K | MBIC0NST0P); 

return; 

) 

/* Save in INI file */ 

WriteProfileString (“WMENU", "CurrentDirectory". 


case IDMQUIT: 
DestroyWindow (hWnd); 
return; 
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WMENU creates one window of the UMENU_Class class. The 
window’s width is set to the screen’s width (using GetSystem- 
Metrics(SM_CXFULLSCREEN)). The window’s height is two 
pixels larger than the height of a caption bar and menu (Get- 
SystemMetrics (SM_CYMENU) + GetSystemMetrics (SM_CYCAP- 
TION) + 2). 

The window handler is quite simple. It contains cases for 
only two events: UM_COMMAND and m_DESTR0Y. If you were 
content to use predefined menus, you could stop at this point. 
You’d simply define the menu choices you wanted in the . rc 
file and write a specific case for each choice in menu(). Each 
case would call UinExec() with a predefined set of argu¬ 
ments. WMENU’s design goals are more 
ambitious, however. Inside UinMain(), 

WMENU obtains an HMENU handle to its 
main menu l/nainmenu). It then calls the 
read_file() function. This function par¬ 
ses a file name from the command line, 
and processes it. 

When WMENU needs to create a new 
main menu item, it calls CreatePopup- 
Menu() to make a new menu and then 
calls AppendMenuf) to add the new item 
to the main menu. The MF_P0PUP argu¬ 
ment to AppendMenu() informs Windows 
that you are adding a submenu, not a 
discrete menu choice. 

WMENU uses AppendMenu() without 
MF_POPUP to add menu choices. The 
menulines array stores up to 100 com¬ 
mand lines. When WMENU is finished 
modifying the menu, it calls DrawMenu- 
Bar() to make sure the main menu dis¬ 
plays properly. Figure 2 summarizes the 
menu-related functions that WMENU 
uses. 

menu() detects user-defined menu 
items (these have IDs of 200 or greater). 

If the command line begins with an 
asterisk, WMENU calls get_input() to 
edit the command line. Menu items with 
values less than 200 are from WMENU’s 
file menu and are processed in a con¬ 
ventional switch statement. WMENU’s 
get_input() provides a simple dialog 
box with an edit control and two push¬ 
buttons. This dialog box allows WMENU 
to edit command lines (and read direc¬ 
tory names). 

Another often overlooked Windows 
gem is the MessageBoxf) function. 

WMENU uses this predefined dialog box 
as an “about box" and for displaying 
error messages. Note that you can pass 
a NULL window to MessageBoxf). By 
doing that, you can display a dialog box 
from inside UinMain() with no window 
or resources defined. 


Listing 2 continued 


) 

/* Process file */ 

int file_read (LPSTR cmdline) 

{ 

FILE *f; 

char far *p, *sp = string; 

/* get filename from cmdline. We must copy it to a local 
buffer since we will probably want to use small model. 
fopen() won't take an LPSTR (long pointer to string) 
as an argument. */ 


Fast, Full-Featured SQL Engine for Windows 

Ideal for mobile computing as an extension to Client/Server systems 
and applications that run on small to medium sized LAN file servers. 
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Quadbase-SQL for Windows v2.0 is an industrial-strength SQL relational database 
engine, bundled with a set of powerful tools, that allows Windows developers to build 
applications using various languages like Visual Basic, Realizer, Toolbook, 
SQLWindows, C, C++, ObjectView, etc. A unique language-independent embedded SQL 
interface included with the system makes using any Windows language easy. The SQL 
engine, implemented as a DLL, is fully ANSI SQL 86 level 2 compliant, and supports the 
Microsoft ODBC standard, which provides seamless, object-oriented access from Visual 
Basic v2.0. Extensions include referential integrity, scroll cursors, and outer join, along 
with other advanced features such as multi-user concurrency control, crash recovery, 
transaction processing, multiple instances, BLOB data, and read-only schemas for CD 
ROMs. The engine is very fast and compact, and is especially designed to manage large 
amounts of data efficiently. Visual Basic development is enhanced by embedded SQL and 
custom controls for browsing and data entry. dQUERY, an award winning query tool/report 
writer, and VBQUERY, an interactive query tool for Windows, are included for quick 
prototyping of SQL statements. A C’ language API is also provided together with an 
embedded SQL preprocessor. The native file format is dBASE. This product is ideal for 
small to medium sized LAN file servers, notebook, or pen-based systems. Users can benefit 
from advanced relational database features while opening a migration path to SQL servers. 

Quadbase Systems Inc. 

790 Lucerne Dr. #51 
Sunnyvale, CA 94086 
Tel: (408) 738-6989 
Fax: (408) 738-6980 


Call for a free demo disk now. 
Find out why AT&T, Hewlett 
Packard, Nike, EPA, GE and 
many more major organizations 
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Listing 2 continued 


/* skip spaces */ 
while (isspace (‘cmdline)) 
cmdline++; 
p - cmdline; 

/* skip to next space */ 
while (*p && lisspace (*p)) 

*sp++ • *p++; 

/* if no file name use wmenu.dat in current directory */ 
if (p == cmdline) 
strcpy (string, "wmenu.dat"); 
else 

*sp = ’\0 1 ; 

f - fopen (string, *r“); 

if (If) 

{ 

MessageBox (topwindow, "Usage: WMENU filename", 
"Filename Required", 

MB_0K I MB_IC0NST0P); 
return FALSE; 


else 

{ 

int menuid = 200; 
char *p; 

/* get line */ 

fgets (string, sizeof (string), f); 

/* chop off \n */ 

p * strchr (string, ‘\n 1 ); 
if (p) 

*p = '\0'; 

/* Set title (first line) */ 

SendHessage (topwindow, WM_SETTEXT, 0, 

(long)(LPSTR)string); 
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/* Get subsequent lines */ 

while (fgets (string, sizeof (string), f)) 

( 

HMENU pop; 

/* chop off \n */ 

char *p * strchr (string, '\n'); 

if (p) 

*p = '\0 1 ; 

/* is this a popup line or a item line? */ 
p • strchr (string, ':'); 
if (!p) 

{ 

/* popup -- create new one */ 

pop » CreatePopupMenu (); 

AppendMenu (topmenu, 

MF_STRING | MF_P0PUP | MF_ENABLED, 
pop, string); 

) 

else 

{ 

*p = 1 \0 1 ; 

/* save command line */ 

menulines[menuid - 200] = STROUP (p + 1); 

/* add to current popup menu */ 

AppendMenu (pop, MF_STRING | MF_ENABLED, 
menuid++, string); 

) 

) 

/* fix menu bar */ 

DrawMenuBar (topwindow); 
fclose (f); 

1 

return TRUE; 

) 

/* Stuff for general purpose input function */ 

static char *ibuf; 

static int isize; 

static char print_buf[513]; 

/* Dialog callback for input function */ 

BOOL FAR PASCAL _export inpdlg (HWND hDlg, 

unsigned message, WORD wParam, LONG IParam) 

{ 

switch (message) 

( 

case WMJNITDIAL0G: 

/* Set title */ 

SendMessage (hDlg, WM_SETTEXT, 0, IParam); 

/* Set prompt */ 

SetDlgltemText (hDlg, 101, print_buf); 

/* Set field */ 

SetDlgltemText (hDlg, 102, ibuf); 
return (TRUE); 

case WM_C0MMAND: 
if (wParam *• ID0K) 

( 

/* read input */ 

GetDlgltemText (hDlg, 102, ibuf, isize); 

EndDialog (hDlg, TRUE); 
return (TRUE); 

) 

/* return NULL for cancel */ 
if (wParam ~ 1DCANCEL) 

I 

ibuf = NULL; 

EndDialog (hDlg, TRUE); 
return TRUE; 

) 

break; 

) 

return FALSE; 

} 


/* Input function — buf of siz bytes contains string to 
edit (or \0). title is the edit box's title, fmt is a 
printf-style format for the prompt. Other arguments 
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The UinExec() function allows 
WMENU to launch other programs easi¬ 
ly. Unlike most other Windows API calls, 
UinExec() returns some useful informa¬ 
tion when it fails. If UinExecf) suc¬ 
ceeds, it returns the new program's in¬ 
stance handle (this isn't documented — 
look it up in Undocumented Windows 
by Schulman, Maxey, and Pietrek). In¬ 
stance handles will always be greater 
than 32, so WinExecf) uses values from 
zero to 32 as error returns (see Figure 
3). WMENU uses the execerr array to 
store error message text for the 14 
documented error return codes from 0 
to 18. If the error code is greater than 
19 (the size of the table) or the string is 
NULL, WMENU uses a default error mes¬ 
sage. 


Conclusion 

WMENU is much different (and 
simpler) than most Windows applica¬ 
tions, yet it serves a very useful pur¬ 
pose. By exploiting menus and dialog 
boxes, it avoids using complex window 
painting and GDI code. You may think 
that a menu-only program would be of 
limited use. However, many practical 
programs lend themselves to this ar¬ 
chitecture, for example: 

• Multimedia control programs 

• Network control programs 

• Programs that do predefined printing 
or file tasks. 

Other programs can rely solely on 
dialogs — to provide form-based 
database screens, for example. Find a 
few programs require no more than a 
MessageBox() function or two inside 
UinMainf). 

While you should understand how 
to write full-scale Windows applications, 
you should also recognize that this is 
overkill in many cases, when you need 
to write a simple Windows program, let 
Windows do most of the work for you. 


References 

Schulman, Andrew, David Maxey, and 
Matt Pietrek. Undocumented Win¬ 
dows. Reading, MA: Addison-Wesley, 
1992. 

Williams, Al. Commando Windows 
Programming. Reading, MA: Addison- 
Wesley, 1993. □ 


Figure 2 Menu-related calls 

HMENU GetMenu(HWND w); 

Returns a handle to the menu for the specified window. 


HMENU CreatePopupMenu(void); 

Creates an empty popup menu and returns a handle for it. 


BOOL AppendMenu(HMENU menu,DWORD flags,WORD id.LPSTR item); 

Adds a popup menu or menu item to an existing menu. The meanings of the 
id and item parameters differ depending on the value in flags. For example, 
id can be a menu ID or a handle to a popup menu. The item parameter can 
contain a string, a bitmap handle, or a user-defined value for owner-draw menus. 


void DrawMenuBar(HWND w); 

Updates the window’s menu bar. You must call this if you modify a window's 
main menu bar. 
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Listing 2 continued 


are for % args in fmt. */ 
char ‘get_input (char *buf, unsigned siz, 

char ‘title, char *fmt,...) 

( 

FARPROC dlgfunc; 
int rc; 

va_list alist; 
va_start (alist, fmt); 

/* print prompt to print_buf */ 
rc - vsprintf (print_buf, fmt, alist); 
if (rc != -1) 

( 

dlgfunc - MakeProcInstance ((FARPROC)inp_dlg, hlnst); 
if (Idlgfunc) 
return NULL; 
else 

( 

/* call dialog */ 

ibuf = buf; 
isize » siz; 

rc * DialogBoxParam (hlnst, “InputBox", 

NULL, dlgfunc, (long) title); 
FreeProcInstance (dlgfunc); 
if(rc < 0) 
return NULL; 

) 

) 

return ibuf; 

) 

/* End of File */ 
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Listing 3 wmenu.h — Header file for wmenu.c 


BOOL init app (HANDLE); 

BOOL initjnst (HANDLE, int); 

long FAR PASCAL ^export win_proc (HWND, WORD, WORD, LONG); 

void menu (HWND, int); 

int init (HANDLE, HANDLE, int); 

int fi1e_read (LPSTR); 

char *get_input (char *buf, unsigned siz, 

char ‘title, char *fmt,...); 

/define IDM_DIR 100 
/define IDM_AB0UT 101 
/define IDM~QUIT 102 
/* End of File */ 


Listing 4 wmenu.rc — Resource definitions for 
wmenu.exe 


/include <windows.h> 

/include "wmenu.h" 

WMENU MENU 
BEGIN 

POPUP "&Fi1e" 

BEGIN 

MENUITEM “&Directory...",IDMDIR 
MENUITEM “&About WMENU..IDM_AB0UT 
MENUITEM "E&xit",IDM_QUIT 
END 
END 

InputBox 0IAL0G 100,100,144,75 

STYLE DS_M0DALFRAME | WS CAPTION | WS_SYSMENU 

CAPTION “Input" 

BEGIN 

LTEXT "Prompt" 101,0,5,144,32 

EDITTEXT 102,10,34,130,12,WS_TABST0P | ES_AUT0HSCR0LL 
DEFPUSH8UTT0N "OK" ID0K,10,59,32,14,WS_GR0UP 
PUSHBUTTON "Cancel” IDCANCEL,100,59,32,14,WS_GR0UP 
END 


Figure 3 The WinExec call 


WORD WinExec(LPSTR cmd.WORD show); 

cmd —String that indicates the command to execute. If the 
program's name does not contain directory information, it 
must reside in the current directory, the Windows 
directory, the Windows system directory, or on the path. If 
the program has no explicit extension, WinExec () assumes 
.EXE. 

show —This integer specifies how to show the new 
program's window (e.g., minimized, normal, etc.). This 
number is the same as the one passed toShowWindowf). 
Common values are: SW_SHOW, SW_SHOWMINIMIZED, 
and SW_SHOWMAXIMIZED. 

WinExec () returns an instance handle for the new program, if 
successful. \fWinExec() can't execute the program, it returns a 
value less than 32 (see theexecerr array in WMENU for a list of 
codes). Note that when you run a DOS program, a successful 
return value only shows that WinOldAppO (the Windows DOS 
program manager) ran —the DOS program may not have 
successfully started. 
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BASIC Path Finding 



Murray L Lesser 


Despite sometimes heated arguments to the contrary, there is no “best” program¬ 
ming language. The "best" programming language to use for a given application is 
the one whose intrinsic capabilities best match the requirements of that application. 
For example, the unique intrinsic capabilities of BASIC are its automatic variable- 
length string management and its automatic file-error checking. In my opinion, this 
makes modern compiled BASIC, enhanced with assembled procedures, the “best” 
language to use for text-processing applications and for commercial data-processing 
applications involving a great deal of string handling. 

Unfortunately, BASIC -as supplied by Microsoft — does not include a method for 
finding the path to the directory containing the executable file being run (equivalent 
to C's argv[0]). This information is essential for applications using subsidiary data 
files, such as configuration files to customize the program for the system it is running 
on. I decided it was easier to add the missing capability to BASIC with an assembled 
function than it would be to program otherwise ill-suited applications in C. 

The assembled function copies the fixed-length string in the Program Environment 
Segment (showing the source of a running program) to a BASIC variable-length string 
in string space. Prior to Microsoft's BASIC version 7.0, there was no documented way 
to perform this feat; the manuals all warned against trying to write an assembled 
string function (one returning a variable-length string). Of course, the BASIC library 
support functions that copy fixed-length strings to variable-length managed strings 
have always been available-, all that is required is access to those previously undocu¬ 
mented string-management functions. 

FINDIR.ASM (Listing 1) uses two of those BASIC library string management func¬ 
tions, B$ASSN and B$STDL, perhaps better known by the documented aliases given to 
them in BASIC 7.0; StringAssign and StringRelease, respectively. It might clarify 
matters if I review BASIC's automatic string-management system before describing 
FINDIR. 

BASIC String Management 

The BASIC entity directly related to the use of a string variable is a four-byte 
string descriptor placed in the fixed-data portion of DGROUP by the compiler and 
linker. Prior to BASIC 7.0, the string descriptor always pointed to the location of the 
actual string in the "near" string space portion of DGROUP. (Near string space is all 
the space available between the top of the fixed-data space and the bottom of any 
file buffer space-, file buffer space is just below stack space. These four [or three, if 
no files are open] spaces fill DGROUP.) The first word in a near string descriptor is an 
integer giving the length of the string text in string space; the second word is a 
pointer to the offset (from the base of DGROUP) to that text. String descriptors point¬ 
ing to Null strings show a zero-length word and a dummy address pointer. When a 
program starts, all string descriptors point to Null strings. 


Murray L. Lesser received a BS degree in Engineering from CalTech in 1942 and earned 
his living as a programmer until 1954, when he joined IBM to work in what would 
become ‘systems architecture." He has been programming microcomputers and writ¬ 
ing books and articles about the subject since 1979 (but claims no responsibility for 
the IBM PC, having retired before it was announced). 
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Each stored string text is preceded by a "valid string" in¬ 
dicator that includes a back pointer to the string descriptor. 
Text of odd-length strings is padded with a fill character so all 
stored entities in DGROUP start on word boundaries. 

In addition to the string descriptors, the string manage¬ 
ment system uses a fixed pointer to the base of string space 
and two variable pointers: one pointing to the current top of 
“used” string space and the other to the top of currently avail¬ 
able total string space. 

When a fixed-length string (either as declared in the pro¬ 
gram source code or an input string value) is assigned to a 
string variable, a new valid-string indicator is written into the 
first available “unused” string space, followed by a copy of the 
string text. Then, both the string descriptor and the "top of 
used” pointer are updated. If the new string is assigned to a 
variable that already had a string assigned to it, the "old” 
string in string space is marked as invalid before the new 
string value is written into the available location. 

Eventually, string space might become full, even though it 
might contain many “invalid” strings. At that time, BASIC's 
automatic garbage collection takes over. To simplify a bit, gar¬ 
bage collection rewrites all the valid strings, starting at the 
bottom of string space, resetting the current "top of used 
space” pointer and the string descriptors as it goes. If, after 
garbage collection, there still isn't enough room in string space 
to write the new string variable, an "Out of string space” error 
is generated. 

Intrinsic BASIC string functions may include writing inter¬ 
mediate “temporary” strings into string space as part of the 
procedure, which may limit the amount of string space avail¬ 
able for assigned string variables. To alleviate this problem in 
programs requiring a large number of long strings, BC 7.0 and 
later versions allow compiling for “far” string space. In far- 
string mode, up to four string spaces are available, none of 
which is in DGROUP. If enough conventional memory is avail¬ 
able above that originally claimed by the program, each string 
space can hold up to 64Kb bytes. The two most-used far 
string spaces are the one containing all string variables 
created in the "main” module and the one containing all tem¬ 
porary strings along with all simple string variables created in 
called procedures. 

When far string space is used, the interpretation of the 
string descriptor (still in the fixed-data space of DGROUP) is 
“Microsoft proprietary” so the descriptor cannot be parsed to 
determine the length and location of the actual string text. 
BASIC 7 provides two more library functions, StringLength and 
StringAddress that can be called in assembled modules need¬ 
ing this information. [Under BC 7, StringAddress returns a four- 
byte far address, even if the program is compiled for near 
strings; StringLength returns an integer.] 

String Conversion Functions 

B$ASSN ( StringAssignf)) is used by BASIC to copy fixed- 
length strings in data space to variable-length strings in string 
space, managing all the necessary pointers as it does so. BASIC 
also uses the same function to copy the text of variable- 
length strings into fixed-length strings. Since B$ASSN is an 
overloaded function, it requires more parameters to be passed 


to it, and more runtime decision making, than would be re¬ 
quired if only one-way copying were provided. 

Before calling B$ASSN from an assembled procedure, you 
must push six words on to the stack — three for the source 
string, followed by three for the destination string. Each three- 
word set contains, in order pushed: the segment address of 
the string, the offset address of the string, and the length of 
the string. The address used for string variables is the seg- 
menuoffset address of the string descriptor, always in DGROUP-, 
a zero length identifies it as a variable-length string. The ad¬ 
dress used for a fixed-length string is the segmenhoffset ad¬ 
dress of the text, wherever it might be, and the length is the 
actual length to be copied. 

There is a potential booby trap in B$ASSN, a consequence 
of its two-way street: you must never pass it a zero-length, 
"fixed-length” string. If you do, B$ASSN assumes you are copy¬ 
ing between two variable-length strings and uses the first four 
bytes found at the address given for the “fixed-length” string 
as a string descriptor —the results are unpredictable. 

Since you can’t “null” a string variable with B$ASSN, BASIC 
provides another way. B$STDL ( StringRelease()) requires 
only one input parameter: the offset (in DGROUP) of the string 
descriptor. This offset is the value passed to any called proce¬ 
dure having a string variable as an input parameter. 
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Listing 1 findir.asm 


.MODEL MEDIUM 

*********************************************************************** 

FINDIR.ASM 

FINDIR [DECLARE FUNCTION FINDIR$ ()] is an assembled string function 
for compiled Microsoft BASIC programs. It returns the complete path 
(including drive code) to the directory containing the executable file 
for the calling program. FINDIR returns a null string if running 
under DOS versions prior to 3.0. 


Copyright (C) 1991-92 by Murray L. Lesser 
*********************************************************************** 


EXTRN B$ASSN: FAR 
EXTRN B$STDL: FAR 


;BASIC support functions in BC 4.x, 
; and later, link libraries 


.DATA 

PATH 

• CODE 


FINDIT: 


Now, 


DONE: 


DD 

? 

•.Returned string descriptor 

PUBLIC 

PROC 

FINDIR 


PUSH 

BP 


MOV 

BP.SP 


PUSH 

DI 


PUSH 

SI 


MOV 

AH.30H 

;Check for DOS version 

INT 

21H 


CMP 

AL,3 

;Version 3.0 or later? 

JB 

NULLIT 

;If not, return null string 

MOV 

AH.62H 

;Find PSP segment address 

INT 

21H 


MOV 

ES.BX 

; and put it in ES 

MOV 

AX,ES:2CH 

;Find program environment segment 

MOV 

ES.AX 

; and put it in ES 

jp to scan for double null 

: 

XOR 

CX.CX 

;Assume Environment less than 64K bytes! 

XOR 

DI, DI 

;Start of environment segment 

XOR 

AL.AL 


REPNZ 

SCASB 

;Find next zero byte 

MOV 

AL,ES:[DI] 

;Is it followed by another? 

OR 

AL.AL 


L00PNZ 

FINDIT 

;If not, keep trying 

double 

nul 1: 


MOV 

CX.-l 

;Reset CX to -1 

INC 

DI 

;Skip second null and string count 

INC 

DI 


INC 

DI 


MOV 

BX.DI 

;Save starting offset of path in BX 

REPNZ 

SCASB 

;Find null after program name 

NOT 

CX 

[Length of string to null 

scan backwards to find last "\" in string; 

STD 

DEC 

DI 

;Start at null byte 

MOV 

AL, 'V 


REPNZ 

SCASB 


CLD 


;Clear direction flag 

INC 

DI 

[To byte containing "V 

CMP 

AL,ES:[DI] 

[Check that it really is a "\" 

JNZ 

NULLIT 

[If not, return null string 

INC 

CX 

[Correct to returned string length 

into BASIC string for return: 

PUSH 

ES 

[Far address of source string 

PUSH 

BX 


PUSH 

CX 

[Length of source string 

PUSH 

DS 

[Far address of destination string 

MOV 

AX,OFFSET PATH 


PUSH 

AX 


XOR 

AX, AX 

[Zero length of BASIC string 

PUSH 

AX 


CALL 

B$ASSN 


MOV 

AX,OFFSET PATH 

[Return string descriptor in AX 
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Where Am I? 

FINDIR.ASM (Listing 1) is a BASIC im¬ 
provement on the C language argv[0] 
string. As all C programmers know, 
argv[0] is a copy of the Program En¬ 
vironment string holding the complete 
file specification for the executable file 
currently running. Since it is a pretty 
stupid program that doesn't know its 
own name, the only useful information 
supplied by argv[0] is the path portion, 
obtained by deleting all of the string 
following the last (rightmost) backslash 
character. FINDIR does the name-delet¬ 
ing for you. It returns only the complete 
path — including the drive code, all in¬ 
tervening directories from the root 
directory, and the final backslash sym¬ 
bol. 

FINDIR starts by checking for the DOS 
version number, since the necessary in¬ 
formation is not available if running 
under versions earlier than 3.0. If the 
version criterion isn’t met, FINDIR 
returns a Null string. 

For DOS 3.0 and later, FINDIR locates 
the string describing the complete file 
specification to the running program, as 
stored in the Program Environment Seg¬ 
ment. After scanning to the end of this 
string, the direction flag is set [STD] 
and the string is scanned backwards, 
looking for the rightmost backslash 
character. Remember, if you set the 
direction flag for a backward scan in a 
BASIC assembled procedure, you must 
clear it [CLD] before calling another 
procedure or returning from this one. 

The found backslash symbol is 
verified, since there is a possibility of 
failure. The complete file specification, 
starting at the drive root directory, is 
written into the Program Environment 
Segment for any program executed 
from COMMAND.COM or by compiled 
BASIC’s RUN statement. However, 
programs residing in a default directory 
and run from a DOS-based debugger 
such as DEBUG or SYMDEB will not show 
a backslash in the Environment string 
unless the complete path was included 
in the debugger command. If FINDIR 
cannot find this backslash symbol, it 
will return a Null string. 

As do all BASIC string functions, FIN¬ 
DIR does not really return a string; it 
returns the two-byte offset (in DGROUP) 
of the string descriptor pointing to 
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Listing 1 

continued 

POP 

SI 

POP 

DI 

POP 

BP 

RET 


NULLIT: MOV 

AX,OFFSET PATH ;Make output null string 

PUSH 

AX 

CALL 

B$STDL 

JMP 

DONE 

FINDIR ENDP 


END 


; End of File 



The quality imaging solution 


| AccuSoft Image Format Library 3.0 

Read, write, display, print and process 12 raster file formats! 
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• High-speed Group HI & Group IV compression/decompression 

• Multi-page and embedded images supported 

• Complete image processing including zoom, scroll, rotate, invert, sharpen, 
contrast, brightness, crop, resize, fit-to-window, thumbnails, dithering, etc. 

• Complete color reduction and conversion functionality 

• High-speed display for all video modes 

• Open architecture allows direct access to uncompressed image data 

• High-level interface with single function call to handle all 12 formats 

• Low-level interface to control process one line at a time 

• Memory to memory compression and decompression supported 

• Source code available (100% ANSI C portable version also available) 

• Call for complete details by FAX 
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No Royalties 

Format Compatibility Guarantee™ 

(800)525-3577 ^ 

Ask about our 30 minute delivery program! 
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The AccuSoft Image Format Library family of products come with an 
iron-clad guarantee of compatibility! All flavors and encodings of raster 
images in all 12 file formats are supported; guaranteed. These toolkits have 
become the worldwide standard for quality file format support. Call today 
to find out why so many companies rely on us to provide the best imaging 
solutions available. 

AccuSoft Image Format Library (DOS & WIN) - $495 
AccuSoft Image Format Library /VB - $495 
AccuSoft Image Format Library AVatcom - $795 
AccuSoft Image Format Library /NT - $995 


AccuSoft Corp. 

160 E. Main St 
P.O. Box 1261 
Westborough, MA 01581 


30 dav money-back guarantee 


(508) 898-2770 
(508) 898-9662 (FAX) 


AccuSoft 

Corporation 

Precision Crafted Software" 
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* Real & protected mode 16-bit support 
► 32-bit protected mode support 

* Wide range of graphic adapter support 

* Virtual screens 

* Multiple simultaneous graphics adapters 
1 BGI interface available 

$250, No Royalties 


\-32\ M 32-bit DOS Extender 

•Up to 3.5 gigabytes of virtual memory 

• l Iltra compact, self-contained executables 

• Fully compatible with Zortech's DOSX 

• Support for Wateom C9.0/386 

• Flash Graphics and Flash View compatible 

$250, No Royalties 
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Source level debugger for ( 
assembler programs. 

Easy to use expansion of classes, 
structures, pointers, arrays, etc. 

Powerful run-time memory protection 

detects pointer bugs 

Full nested call traceback display with 

automatics and parameters 

Unlimited number of break and trace points 

History buffer for recording up to 

32,000 source lines and variables 

Program execution time recording for 

timing analyses 

Dual monitor debugging 


$250 

FlashTek is proud to offer former Zortech 
products, by the original authors, now with ; 
support for other compilers. New features, ! 
fantastic support, no royalties, and great i 


I ORDERS 800-397-7310 

... 1XL . FlashTek, LTD 

Hash I ek, Inc. Partnership House 

i t sweet Ave Withambrook Park 

Moscow, Idaho 8oo4o ., T . 

Info: 208-882-6893 

Email: nash@proto.com E"g |and NG319SX 

k.\\. ?08-88 9 -7 9 75 Voice.+44-476-74108 

‘ ‘ Fax: +44-476-61382 

Borland, BGI, Wateom and Zortech are trademarks of 
their respective companies. 


FINDIR's finding. If you assign this value 
to a string variable, a second copy of 
the actual string text will be written in 
string space, and the string descriptor 
belonging to the variable will be up¬ 
dated accordingly. 

Using FINDIR 

My original version of FINDIR was as¬ 
sembled with Microsoft MASM 5.1. Since 
the advent of MASM 6.0, I have 
switched to Borland's TASM 2.5 (the one 
distributed with Borland C++ 2). These 
two assemblers do not produce identi¬ 
cal object code, but either object 
module can be installed in a private 
library using Microsoft's LIB program, 
and both will produce the same ex¬ 
ecutable file when linked to the same 
compiled BASIC object module with 
Microsoft's LINK. (It is not possible to 
link Microsoft BASIC programs with 
Borland's TUNK.) 

DEM0FIND.BAS (Listing 2) is a 
demonstration program simulating the 
way FINDIR might be used in an ap¬ 
plication program. After locating the 
proper directory, a real program would 
check to see if the needed subsidiary 
file exists in that directory. If not, 
depending on the situation, the pro¬ 
gram would either have the user write 


the needed file interactively, or ter¬ 
minate with a suitable error message. 
In this demonstration, the first time 
DEMOFIND is executed, it creates the 
necessary TEST FILE before terminating. 
On successive calls, TESTFILE is read 
and its contents displayed. 

As written, DEMOFIND cannot be 
compiled with any BASIC compiler prior 
to BC 7.0, since it uses the BASIC built-in 
DIR$ (Find first) function, which was 
not available until that version. If you 
are using FINDIR in a BC 4.x program, 
the equivalent “not found” test is to 
trap the error signaled by the attempt 
to open a missing subsidiary file for se¬ 
quential input. 

I use a virtual disk and usually run in 
a DESQview-386 “Big DOS” window 
when testing new programs or proce¬ 
dures, to allow relatively easy recovery 
from unexpected catastrophes. If you 
are trying DEMOFIND from a directory on 
a real disk, don't forget to delete all 
DEMOFIND files and TESTFILE before 
you shut up shop. Leaving unused small 
files scattered about makes hard-disk 
housekeeping more difficult than it 
need be. □ 


Listing 2 demofind.bas 


1 demofind.bas - a demonstration driver for FINDIR.ASM 
1 compiled with BC 7.1, switch "/0" 

1 linked with LINK 5.1 to FINDIR, N0FLTIN, N0C0M and NOLPT 
1 switches “/E/NOE" 

declare function findir$ () 
defstr f,t 

if len(findir) = 0 then 'Too early version of DOS 

print "This program requires DOS 3.0 or later” 
end 'Abnormal termination 

end if 

let filename = findir + "testfile" 

if 1en(dir$(fi1ename)) = 0 then 'Not there yet? 

print tab(5) findir“TESTFILE didn't exist, 
open filename for output as #1 
let text = "TESTFILE exists" 
print #1, text 
close #1 

print "but now it has been written." 

else 

open filename for input as #1 
line input #1, text 
print tab(5) findir; text 
endif 
end 
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Writing a Control Panel Applet 
for Windows NT 

Paula Tomlinson 


The Control Panel in Windows NT, like its predecessor in Windows 3.x, gives users 
a graphical way to configure and customize their hardware and system-level 
software environment (e.g., to configure ports for printers or customize Desktop set¬ 
tings). The Control Panel client area displays an individual icon for each category of 
device or function, providing a consistent location for user modification of these 
settings. You might think of the Control Panel program ( control.exe) as a slate for 
displaying and launching Control Panel applets. 

Creating a Control Panel applet to add system-level visibility and support of a 
new device type is relatively simple. This article outlines the steps necessary to 
create a simple Control Panel applet for scanners. The scanner applet provides 
general scanner device functions and exports a standard API that allows manufac¬ 
turers of vendor-specific devices to add their own value-added features. 

Before writing a Control Panel applet, review the installable driver interface and 
the standard ''Drivers" Control Panel applet, both of which are documented in the 
Windows 3.1 DDK, but so far only mentioned (far from completely) in the Windows 
NT online help files. The installable driver interface provides a standard interface for 
accessing multimedia devices, while the Drivers applet includes installation and con¬ 
figuration features for such devices. If your device falls into the multimedia category, 
you should strongly consider using this interface rather than building a custom Con¬ 
trol Panel applet. 


Pavla Tomlinson received an Electrical Engineering degree from Colorado State Univer¬ 
sity and is an engineer with Hewlett-Packard. Her experience includes the develop¬ 
ment of Windows printer drivers, Windows 3.x VxDS, Windows NT VDDs, Windows NT 
DLLs, DOS Device Drivers, TSRs, and a variety of DOS and Windows-based commercial 
applications. The opinions expressed in this column are hers alone and do not neces¬ 
sarily reflect the opinions of Hewlett-Packard. Send questions or correspondence to 
Paula via Internet as hpscanner@hpgrla.gr.hp.com. 
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The CPIAppletO Entry Point 

Control Panel applets are supported by Control Panel 
Libraries (CPLs). A CPL can support multiple Control Panel ap¬ 
plets, each having its own icon on the Control Panel client 
area. For example, main.cpl contains the applets for Color, 
Fonts, Ports, Mouse, Desktop, Keyboard, Printers, International, 
Date/Time, and Networks. A CPL is essentially just a DLL that 
contains the following special callback routine: 

LONG CALLBACK CPI Applet(HWND, WORD, DWORD, DWORD) 

The Control Panel uses this routine to communicate with 
each applet. You must define it in your CPL and export it, 
either with the _export keyword or by listing it in your 
module definition file. The first CPIAppletO parameter is the 
handle to the Control Panel window. The second parameter is 
a message ID that the Control Panel uses to notify each applet 
of events and requests for information. The third and fourth 
parameters vary depending on the message ID. There are 
eight different messages the Control Panel may send to a CPL 
via CPIAppletO. These messages can be categorized as in¬ 
itialization messages, user-initiated messages, and termination 
messages. 

Initialization Messages 

When invoked, the Control Panel loads each applet that it 
finds and immediately begins sending initialization messages 


ATTENTION 


Cobr Developers 

The Candela Color Management System is a soft¬ 
ware library that provides an extensive set of proven 
color tools for complete color calibration and real¬ 
ization for “C” programmers. 

Available For These Environments: 

• Macintosh MPW & Think C 

• NeXT NeXTSTEP 

• PC Windows 3.1 DLL & DOS 

• Sun SPARC Sun Solaris 1.1 & 2.x 

An 85 page Application Program Interface (API) is 
available to qualified developers. 

Ask for the 

Candela Color Management System 
(CCMS) Library-API 

612 - 894-8890 


CXNDelfcs 

1676 East Cliff Rd. 
Burnsville, MN 55337-1300 
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Listing 1 scanaplt.c — Windows NT control panel 
applet 


_______ ** 

** SCANAPLT.C: Main entry-points for the Windows NT 
** scanner Control Panel Applet. 

** Environment: Windows NT. 

** (C) Hewlett-Packard Company 1993. PLT. 

★ __ ** f 

/**-Include Files-**/ 

finclude <windows.h> 

linclude <cpl.h> /* control panel defines */ 

^include <winreg.h> /* registry prototypes */ 

finclude <stdlib.h> /* prototype for atoi */ 

finclude "scanaplt.h" 

/**- Public Function Prototypes -**/ 

INT APIENTRY LibMain(HANDLE, ULONG, LPVOID); 

LONG CALLBACK CPlApplet(HWND, UINT, LPARAM, LPARAM); 

/**-Private Function Prototypes-**/ 

BOOL WriteScannerRegistry(HWND, LPTSTR); 

BOOL ReadScannerRegistry(HWND, int); 

BOOL DeleteScannerRegistry(HWND, LPTSTR): 

BOOL ReadInfFile(HWND, LPTSTR); 
void ReplaceCommasWithTabs(LPTSTR); 
int GetVendorCapabilities(LPTSTR); 
void GetVendorModule(LPTSTR, LPTSTR); 
void GetVendorValue(LPTSTR, LPTSTR); 

/**.Global Data.**/ 

HINSTANCE hlnst; 

int iCap=0, index=0; 

char lpBuffer[MAX_STR_LEN+l]; 

J*********************************************************** 

** Routine: LibMain 

** Called by Windows when a DLL is loaded. Perform your 
** process or thread specific initialization tasks here. 

** Return: Return 1 if initialization successful. 
*********************************************************** ^ 
INT APIENTRY LibMain(HINSTANCE hModule, ULONG ulReason, 

LPVOID IpReserved) 

1 

hlnst = hModule; 
return 1; 

) /* LibMain */ 

j*************************** ******************************** 

** Routine: CPIApplet 

** Standard callback entry point for the Control Panel. 

***********************************************************j 

LONG CALLBACK CPlApplet(HWND hWndCPL, UINT msg, 

LPARAM lParaml, LPARAM lParam2) 

{ 

LPNEWCPLINFO 1pNewCPlInfo; 

switch (msg) 

{ 

case CPLJNIT: 

/* Sent (once) immediately after DLL loaded */ 
return TRUE; 

case CPL_GETCOUNT: 

/* Sent after CPL_INIT message, return t of apps */ 
return NUM_SCANNER_APPS; 

case CPLJNQUIRE: 

/* obsoleted by CPL_NEWINQUIRE, just return FALSE */ 
return FALSE; 

case CPLJEWINQUIRE: 

/* Sent after CPL_GETCOUNT, once for each applet */ 

1pNewCPlInfo = (LPNEWCPLINFO)1Param2; 

1pNewCPlInfo->dwSize = (DWORD)sizeof(NEWCPLINFO); 

1pNewCPlInfo->dwFlags = 0; 

1pNewCPlInfo->dwHel pContext = 0; 
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Blaise Declares War on Prices 


When a $700 compiler 
sells for $189 ... how 
much should you pay for 
your add-on libraries?" 
asks Blaise President. 

Berkeley, CA-Blaise Computing 
declared war today by slashing 
prices on their entire line of 
developer support libraries and 
utilities, including the just re¬ 
leased Control Palette/NC, as 
well as new versions of their 
hottest selling products. 

Win ++ 2.30 

New Release 

The latest version of one of the 
most extensive Windows class 
libraries available. Makes writing 
even complex Windows appli¬ 
cations easier. Over 150 classes 
including GDI, MDI and even 
DDI. Supports Borland C++ 3.1. 

Regular Price $69 

C Tools Plus 

Full-featured DOS support lib¬ 
rary for Microsoft C/C++. With 
virtual text-mode windows, 
plus mouse support and write 
TSRs. Essential for DOS text¬ 
mode applications. 

Regular Price $49 

Asynch Plus 

Pascal asynch support library. 
Supports BP7, completely inter¬ 
rupt driven, full modem and file 
transfer support. 

Regular Price $69 


Control Palette/NC 

New Product 

Customize the Windows 
nonclient areas: title bars, menu 
bars, border and scroll bars. You 
won’t find another product like 
this! C/C++, Pascal, OWL and 
MFC support. 

Regular Price $49 



View 232 

Turn your PC into a full function 
communication dataline monitor. 
Trap specific data sequences, 
save to disk, watch line activity. 
Special cable included. 

Regular Price $69 

Power Tools Plus 

A comprehensive DOS support 
library for Borland Pascal; with 
virtual text-mode windows, me¬ 
nus and pick lists, plus sensors, 
mouse support and write TSRs. 
A must for Pascal programmers. 

Regular Price $49 



Control Palette 


New Release 

An extensive custom control 
library for Windows, including 
ribbons, status lines, tool bars, 
list and combo boxes. C/C++, 
Pascal, OWL and MFC support. 


Regular Price 


$49 


C Asynch Manager 4.0 

New Release 

A completely interrupt driven 
asynch support library. 16650 
FIFO support, all baud rates. 
XMODEM, YMODEM, ZMO- 
DEM and Kermit file transfer, as 
well as smart modem support. 
And Microsoft and Borland C++ 
support. 

Regular Price $69 


Turbo Vision DT 2.0 

New Release 


This is the only commercial 
resource editor for Turbo Vision 
available. A must have for Turbo 
Vision programming. Extended 
class libraries also included. C++ 
and Pascal support. _ _ 

Regular Price $49 


Every product comes with a 
comprehensive printed manual 
and includes ALL source code! 


Take advantage of war-time 
prices by ordering direct from 
Blaise Computing today! 

_ 4 > _ 

BLAISE COMPUTING INC. 

819 Bancroft Way Berkeley, California 94710 (510)540-5441 


ON THE STREET 



Programmers rush to buy 
Blaise products while 
war-time prices last. 


PRICE INDEX 



Prices drop on all Blaise 
Computing products. 


TO ORDER 


CALL TODAY! 

Before Rationing Begins 
or Products are Backordered 

1 - 800 - 333-8087 

Or send check or money order 
to: Blaise Computing, Inc., at 
819 Bancroft Way. Berkeley, CA 
94710. Fax VISA or MC orders 
to (510) 540-1938. Please add 
$7.50 per product for shipping 
and handling. CA residents add 
applicable sales tax. Call (510) 
540-5441 for special shipping or 
international orders. 

At These Incredible Prices, 
All Sales Must Be Final! 
NO DEALERS, PLEASE 
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C CODE FOR THE PC 

source code, of course 

NEW! CDFS (CD-ROM File System for Embedded Applications; High Sierra and ISO-%60 Level 1; portable C with simple device interface) . . . $750 

Embedded DOS (full-features, real-time, multitasking, 3.31-compatible DOS for embedded system and self-bootable installations).$375 

NE W! ChartPro (Windows DDLs to add bar, pie, line/area, and high/low chart to your apps; user dialogs included).$350 

NE W! X/DOS and Xt/DOS (Xlib with X client and Xt toolkit for DOS; port X code to DOS; Xt/DOS requires X/DOS and 32-bit compiler) . . each $345 

Code Base 5 (database manager, dBase and Clipper compatibile indexes & data files; Version 5.0; specify C or C++).$325 

ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

The Snooper (Ethernet protocol analyzer for Novell Net\rare and LAN Manager Networks; capture packets; real-time display).$275 

IbrboTfcX (Release 3.0; HP, PS, dot drivers; CM fonts; LaTgX; MetaFont).$250 

Rogue Wive tools.h+-(- or math.h-(—|- Class Library (extensive docs).each $240 

Updated! C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner).$170 

c-pslib (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support).$170 

TE Editor Developer’s Kit Ver. 3.0 (full screen editor, undo command, multiple windows; with Word Processing $230).$155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; 3.5” diskettes only).$150 

Delorie GCC for MS-DOS (Version 2.2.2; includes C+ +, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

Ibrow (Version 4.1; programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$135 

Booter Tbolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) .$120 

Dr. MD (runtime memory analyzer & debugger; find many memory corruption errors; examine memory usage).$110 

NEW! Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs) .$100 

386BSD Version 0.1 & LINUX Version 0.96 (two Unix clones for Intel 386).$100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

Demacs (complete GNU Emacs for DOS; needs djgcc to build; based on 18.55).$100 

Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features).$90 

HorC++ Power (C+ + Class Library for Borland’s Paradox Engine).$80 

Updated! CPPCOMM (Version 3.0; C+ + serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem) .$75 

ET Neural Net (back error propagation; specify DOS text, DOS VGS, or Windows).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C++).$65 

NEW! Smalltalk for DOS (port of GNU Smalltalk using djgcc).$60 

LDB (Loose Data Binder; portable, persistent container of arbitrary data including pointers).$60 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder's Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS (Purdue Compiler Construction Tool Set; ported to Microsoft Q like YACC and LEX together with lots of additional features) . . . $60 

MEM-WING (global memory manager for Windows, supports standard C memory allocation calls to ”wing” your old C code into Windows) . $55 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

Moby Crypto (Volume 1: DES, Lucifer, SRNG, ARNG; Volume 2: PGP, RSA, MD4, SHA; both volumes $75; not for export).each $50 

OBJASM (convert .obi files to .asm files; output is MASM compatible).$50 

CLIPS Version 5.1 (rule-based expert system generator; advanced manuals available at additional cost).$50 

NIH Class Library & Book (basic C++ classes & Data Abstraction and Object-Oriented Programming in C+ + in softback by Keith Gorien) $50 

Editor Pack (20 public domain editors; microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

MicroC C Compiler (retargetable C compiler/optimizer, lots of docs, very portable, 8086 tables included; tables for 7 extra epu’s $50) .... $50 

PICTOR (Video library: multi-pane windows, menus, hypertext help, serial communications; text editor example; much more).$45 

TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) .$40 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export).$40 

Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C+ + in C) .$35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes Cand C+ + grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

Alloc-GC (a garbage-collecting memory allocation library).$30 

Updated! REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

NEW! Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised).$30 

NEW! OEmacs (full GNU Emacs for DOS and Windows DOS box; C++support, etags++, lots of .el files) .$25 

UUPC Pack (UUCP for the PQ UUPC Version 1.11V, smail & snews) .$25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

FLEX (fast lexical analyzer generator, new, improved LEX; BSD Version 2.3.6 with docs).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better, keeps track of software development).$20 

NEW! Simple Socket Library (Unix, VMS and MS-DOS; sits on TCP/IP stack).$20 

Bywater BASIC Version 1.10 (complete BASIC interpreter and interactive programming environment).$20 

Data 

Moby Thesaurus (25K root words, 1.2M synonyms).$350 

Moby Part-of-Speech (200,000 words and phrases described by prioritized part(s)-of-speech).$120 

Moby Words (500,000 words & phrases, 9,000 stars, 15,000 names).$80 

Moby Shakespeare (plays, sonnets, etc. ... every last word).$60 

Dictionary Word List (234,932 words in alphabetical order).$60 

Roget’s 1911 Thesaurus.$40 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) $35 

The World Digitized (100,000 longitude/latitude of world country boundaries).$30 

Lots ’O Words (160,086 German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) .$30 

CD-ROMs 

FontMaster Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB).$70 

Prime Time Freeware (Volume 2, No. 1, January, 1993; over 1 gigabyte of Unix C code).$60 

NEW! Linux/GNU/X by Yggdrasil Computing (beta release; run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more).$60 

Wklnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included).$55 

NE W! InfoMagic Unix (386BSD Version 0.2, Linux, X including contributed, complete GNU, 2nd Berkeley Networking).$50 

NEW! InfoMagic Internet (RFC’s, IEN’s, Netinfo, 2nd Berkeley Networking, packet drivers, GNU, X, ISODE 8.0, DOS Emacs & C/C++) .... $50 

Walnut Creek C User’s Group (Volumes 100 to 364).$40 

Whlnut Creek XI1R5 and GNU (XI1R5 with contributed and comp.sourcesx, over 120 GNU programs, complete C source).$35 

3%lnut Creek Usenet and Simtel Unix-C (600MB).$35 

WUnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$20 

NEW! Sprite Network Operating System (source code & documentation of Ousterhout’s Sprite O/S; Sun and DECStation boot images).$20 


11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-1342 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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to the CPIApplet() function in each CPL The messages are 
sent in the order in which I discuss them here. 

The Control Panel sends the first message, CPL_INIT, only 
once to each CPL. This message gives each CPL a chance to 
perform any necessary CPL-wide initialization tasks. If the CPL’s 
initialization is successful, it should return TRUE. If CPIApplet () 
returns FALSE, the Control Panel terminates communication 
with that CPL. Returning FALSE to this message is the only 
way to prevent a CPL's applets from being loaded. 

The Control Panel also sends the next message, CPL_GET- 
COUNT, only once to each CPL. This message asks the CPL how 
many applets it contains. The value returned by CPIApplet() 
determines how many icons to display on the Control Panel's 
client area for this CPL and thus how many times the 
CPL_NEUINQUIRE and CPL_ST0P messages (described next) are 
sent. 


Listing 1 continued 


lpNewCPlInfo->lData = 0; 
lpNewCPlInfo->hIcon = LoadIcon(hInst, 
(LPCTSTR)MAKEINTRESOURCE(ICO_SCANNER)); 
lpNewCPlInfo->szHelpFile[0] = 1 \0 *; 
strcpy(lpNewCPlInfo->szName, "Scanners"); 
strcpy(lpNewCPlInfo->szInfo, 

“Adds, removes, and configures scanners."); 
break; 

case CPL_SELECT: 

/* Sent when user selects your applet icon */ 
break; 

case CPL_DBICLK: 

/* sent when user double-clicks your applet icon */ 
OialogBoxfhlnst, MAKEINTRESOURCE(SCANNER_DLG), 
hWndCPL, (DlGPROC)ScannerDlgProc); 
break; 

case CPL_ST0P: 

/* Sent once for each app before Cont-Panel ends */ 
break; 

case CPL_EXIT: 

/* Sent after last CPL_ST0P message */ 
break; 

default: break; 

) /* switch on msg */ 
return TRUE; 

) /* CPIApplet */ 

I *********************************************************** 

** Routine: ScannerDlgProc 
** Dialog box procedure for SCANNER_DLG 
***********************************************************/ 
BOOL APIENTRY ScannerDlgProc(HWND hDlg, UINT msg, 

WPARAM wParam, LPARAM IParam) 

{ 

HINSTANCE hLib = 0; 

FARPROC lpfn = 0; 

static int tabstopsf] = { 400, 500, 600 }; 
static char lpEntry[MAX_STR_LEN+l]; 

switch (msg) 

{ 

case WMJNITDIAL0G: 

SendDlgItemMessage(hDlg, ID_SCANNER_L1ST, 
LB_SETTABSTOPS, 3, (long)(int *)tabstops); 
ReadScannerRegistry(hDlg, ID_SCANNER_LIST); 
return TRUE; 
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3 copy 3 

3 Delete [7] 
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database 

general 


addlbll4 doc 
addlblM doc 
addilbl.doc 



Requires only 6KB of base memory 
Implemented as 100% Windows DLL 
(not a TSR) 

■ All applications are both client and server 

■ Works concurrently with Netware, LAN Manager, 
Vines etc. 

■ Up to 64 concurrent sessions 


Developer Tools: 

Windows Socket API 
Berkeley 4.3 Socket API 
ONC RPC/XDR 
WinSNMP API 


Applications: 

TELNET (VT100,VT220), TN3270, 
FTP, TFTP SMTP/Mail, POP2, 
SNMP, PING, BIND, Statistics, 
and Custom 


Extensible SNMP Agent 

■ Includes MIBII, Workstation,Windows and 
DOS agents 

■ Dynamic registration of multipleagents, managers, 
and proxies 

■ WinSNMP API developers kit available 

■ Compatible with any SNMP manager 

■ Free with NEWT, Chameleon, and ChameleomVFS 

NFS Client/Server 

■ Network drives are mounted from within Windows 

■ Network printing in the background 

■ Up to 24 network drives 

■ Requires only 6KB of base memory 

■ Included in ChameleomVFS 

For overnight delivery call: 

®Nei 'Manage™ 

(408) 973-7171 

20823 Stevens Creek Blvd., Cupertino, CA 95014 USA 
Fax (408) 257-6405 
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TurboT^X 

Typesetting Software 



MIC ROSOFT With C Source 

windows <KQnn 

COMPATIBLE °OUU 


The TjjpC typesetting 
system implemented in 
portable C for MS-DOS, 
Windows, and Berkeley 
and System V Unix. 

T he WORLDWIDE STANDARD for beautiful 
publishing in science and engineering is 
TgX, a set of programs which produce mathe¬ 
matics and text in impeccable clarity and style. 

TurboTgX 3.1 is a best-selling, industrial- 
strength implementation of TgX for the most 
popular operating systems. Included are 
plain TpX, LaTgX, METAFONT, AmS-TgX and 
AmS-LaTf^, the Computer Modern fonts, 
WYSIWYG previewer, drivers for HP Laser¬ 
Jet/DeskJet, PostScript, and Epson LQ and FX 
dot-matrix printers, a 90-page, fully-indexed 
User's Guide, and free technical support. The 
key language references, Knuth's and 

Lamport's LaTfcX User's Guide, are available at 
technical bookstores or from us directly. 

The executables include two ready-to-run ver¬ 
sions: one for MS-DOS 3.0 or later, plus an¬ 
other Microsoft-certified version for Windows. 
Our guarantee: try the executables for 10 days, 
return for a full refund if not 100% satisfied. 

With the source code option, you can recon¬ 
figure the system for novel features, embed 
typesetting in your vertical application, port 
to a new platform, update to a new OS revi¬ 
sion, or just study a major product in detail 
(including the WEB system in C, our Pascal- 
to-C translator, Windows interface, and DOS 
virtual memory simulator). Source requires 
Microsoft C, Watcom C 8.0, or Borland C++ 2.0 
for MS-DOS; Microsoft C for Windows, or a 
32-bit ANSI or K&R C compiler for UNIX. 

Ordering is easy by phone, FAX, or 
mail, and delivery is fast! Terms: M^J 
check with order (free USA ground HIHBB 
shipping), VISA, Mastercard, or 
COD. Net 30 to well-rated firms 
and public agencies. International 
orders welcome. 

Free 70-page Buyer's Guide by mail. 


The Kinch Computer Company 

Publishers of TurboTeX 

501 South Meadow Street 
Ithaca, New York 14850 USA 
Telephone (607) 273-0222 
FAX (607) 273-0484 
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The Control Panel sends CPL_NEHIN- 
QUIRE once for each applet the CPL con¬ 
tains. Your CPL's CPlApplet() should fill 
in a NEHCPLINF0 structure with informa¬ 
tion pertaining to each of its applets. 
The third parameter is an index value 
used to identify that applet in sub¬ 
sequent messages; Control Panel passes 
0 for the first applet in your CPL, 1 for 
the second applet, and so on. You 
should perform applet-specific initializa¬ 
tion when you receive this message. 

Windows 3.0 used the CPLJNQUIRE 
message rather than the CPL_NEUIN- 
QUIRE message. Although CPLJNQUIRE 
still exists for backwards compatibility, 
new Control Panel applets should 
respond to CPLJNEHINQUIRE. The Control 


Panel sends the CPL_N EH INQUIRE mes¬ 
sage first. If the CPL returns FALSE, the 
Control Panel then sends the CPLJN¬ 
QUIRE message. Returning a valid 
response to CPL_NEUINQUIRE ensures 
that CPLJNQUIRE won’t be sent. 

User-Initiated Messages 

User-initiated messages signify that 
a user has selected or executed —either 
directly or through another program - 
an applet contained in your CPL. 

The CPL_SELECT message is sent if 
the user selects (single-clicks) an applet 
icon that is contained in your CPL. This 
message isn't extremely useful, so most 
CPLs don t process it. 



Figure 1 Windows NT control panel with sample applet 
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The CPL_DBLCLK message is sent 
when the user executes (double-clicks) 
an applet icon that is contained in your 
CPL. The third parameter is an index 
value that specifies which one of the 
applets was selected. In response to 
this message, your CPL should display 
its dialog box for that applet. 

Termination Messages 

The last two messages — CPL_ST0P 
and CPL_EXIT — notify the CPL that the 
Control Panel is closing. 

CPL_ST0P is sent once for every ap¬ 
plet contained in the CPL and is sent 
just before the Control Panel is ter¬ 
minated. Its third parameter is an index 
value that specifies which applet con¬ 
tained in the CPL is being terminated. 
Any resources allocated for particular 
applets should be freed when this mes¬ 
sage is sent. 

CPL_EXIT is sent to each CPL only 
once. This is your last chance to per¬ 
form any CPL-wide cleanup. After this 
message is processed, the Control Panel 
calls FreeLibrary() to unload your CPL. 

Choosing the Features 
for the Scanner Applet 

One of the first decisions to be made 
in designing a CPL is whether to parti¬ 
tion the applet functionality into 
general device features and vendor- 
specific features. If all devices of this 
type provide the same basic 
functionality — as is the case with the 
mouse, for example — then you can 
probably get away with a single dialog 
box that allows users to control these 
basic functions. Since scanners vary 
quite drastically in the capabilities they 
provide, I chose to create a general 
scanner applet and an API for adding 
modules to provide vendor-specific 
scanner features. 

I tried to model the functionality of 
my scanner applet loosely after the 
standard Drivers applet. Like the Drivers 
applet, my scanner applet does not pro¬ 
vide vendor-specific features and has no 
vendor-specific knowledge, it simply 
lists currently installed scanner drivers 
(as with printers, it is possible to install 
drivers for scanners that you don’t cur¬ 
rently have!). From the scanner applet 
dialog box, you can add additional scan¬ 
ner drivers, remove existing scanner 


drivers, and configure existing scanners 
and/or drivers. 

I also decided that installing drivers 
is inherently a vendor-specific process. 
For instance, using the Hewlett-Packard 
scanners with 16-bit Windows applica¬ 
tions under Windows NT requires the 
installation of a DOS stub device driver 
in config.nt and the presence of an NT 
Virtual Device Driver in the Windows NT 


System directory. Another recent trend 
in setup programs is to provide uninstall 
capabilities. 

To implement these capabilities 
while still maintaining a very generic 
scanner applet, I defined the following 
three routines and “capability" values to 
notify vendor-specific modules of 
events occurring in the scanner applet: 


WOW! Now With OBJ, Windows, Windows VXD, OS/2, 
and OS/2 LX Driver Support! 

No Source? 

No Problem. 


W ithDis»Doc Professional™, 

the most powerful disassembler 
available, you will be able to 
convert your DOS programs into de¬ 
tailed assembler code to recreate lost 
DOS program listings or find vi¬ 
ruses. 

Dis • Doc Professional was designed 
to be fast and easy for the first time 
user with an interactive mode and 
on-line help, but has all the power a 
seasoned vet needs. Interactive 
searching and nested calls helps you 
find viruses quickly and our built-in 
pacther makes killing them even 
quicker. Dis*Doc Professional con¬ 
tinues to be the industry leader in 
new features, especially in listing 
detail and new programs supported. 

PC MA GAZINE 

Even PC Magazine has changed its 
mind about "the best disassembler 
[theyj've ever seen" in their July 1992 
issue (but then again a lot has changed 
since their last disassembler review 
in 4/26/1988. Ronald Reagan was 
still president for gosh sakes...) 

We are so confident that you will 
love our product, a working demo 
of Dis*Doc is availible free on our 
bulletin board 
(203-953-6196) 
along with other 
information. 


COMPARE FOR YOURSELF! 

Dh-Doc'** 

v4.006 

Brand X 

vx 

AUTOMATIC DISASSEMBLY 
Speed of disassembly (bytes/sec) 

822 

120 

Accuracy %’ 

99.9 

99.9 

Pre-defined comment size(avg)” 

60 

60 

Unlimited file size 

YES 

NO 

LISTING 

Interactive mode 

YES 

NO 

Time to customize a label 

5 sec 

5 min 

Time to change data to code 

5 sec 

5 min 

Interactive Cross Referencing 

YES 

NO 

Custom Label Size(max) 

32 

32 

Custom Comment Size(interactive) 

320 

0 

Japanese character support 

YES 

YES 

MASM & TASM output 

YES 

YES 

OPTIONS 

EXE Unpacker/COM2EXE 

YES 

YES 

OBJ Disassembly 

YES 

NO 

Patcher 

YES 

NO 

Basic Price 

99. 

129.95 

Complete Price*” 

249.95 

309.80 

• Code analysis, segment piacement multiple segments, sag’s end offsets » 

" Interrupt Including aM reg use, port. Window, OS/2, VXD, and LX services. i 

•” Disassembler, BIOS labeling. EXE unpecker, WndowsA OS/2 support | 


SPECIAL OFFER 

For a limited time the interactive 
core of Dis*Doc is availible for just 
$99, packing all the power of 
Dis*Doc Professional but without 
OBJ, Window, OS/2 or packed EXE 
support. 


To order the Dis*Doc™Disassembler call: 

1-800-336-1961 

1-203-489-5335 voice 1-203-489-5746 fax 
1-203-953-6196 bbs (up to 9600 baud 8N1) 
or send check or money order for $249.95 
(or $99 for Dis*Doc's interactive core) 
plus $6 s&h to: 

RJSwantek, Inc. • 33 Spencer Brook Road • New Hartford, CT 

06057 USA 

MasterCard & Visa • Shipped Immediately Via UPS Blue inside USA. 
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Listing 1 continued 


case WM SYSCOMMAND: 

{ 

static char lpFilename[MAX STR LEN+1]; 

If (wParam == SC CLOSE) EndDialog(hDlg, TRUE); 


return FALSE; 

switch (msg) 

/ 

case WM COMMAND: 

case WM INITDIALOG: 

switch ( LOWORD(wParam) ) 

SendDlgItemMessage(hDlg, ID EDIT DRIVESRC, 

{ 

EM LIMITTEXT, MAX STR LEN, OL); 

case IDOK: 

SetDlgItemText(hDlg, ID EDIT DRIVESRC, “A:\\"); 

EndDialog(hDlg, TRUE); 

return TRUE; 

return TRUE; 


case ID SCANNER LIST: 

case WM_COMMAND: 

switch(LOWORD(wParam)) 

if (HIWORD(wParam) ! = LBN SELCHANGE) break; 

( 

if ((index = SendMessage((HWND)lParam, 

case IDOK: 

LB GETCURSEL, 0, OL)) ! = -1L) 

GetDlgltemText(hDlg, ID EDIT DRIVESRC, 

{ 

lpFilename, MAX STR LEN); 

SendMessage((HWND)lParam, LB GETTEXT, index. 

if (lpFilename[strlen(lpFilename)-l] != 1 \\ 1 ) 

(LONG)(LPTSTR) 1 pBuffer); 

strcat(lpFilename, “\\"); 

iCap = GetVendorCapabilities(lpBuffer); 

strcat(lpFilename, "SCANAPLT.INF"); 

if ((iCap & CPL SCANNER SUPPORT CONFIGURE) == 0) 

EndDialog(hDlg, ReadInfFile(hDlg, lpFilename)); 

EnableWindow(GetDlgItem(hDlg, 

return TRUE; 

ID SCANNER CONFIGURE), 0); 


else EnableWindow(GetDlgItem(hDlg, 

case ID ADD HELP: /* call WinHelp */ 

ID SCANNER CONFIGURE), 1); 

MessageBox(NULL, (LPTSTR)"You 1 re doing fine!". 

} 

(LPSTR)"Scanners", MB OK); 

return TRUE; 

return TRUE; 

case ID SCANNER HELP: /* call WinHelp */ 

case IDCANCEL: 

MessageBox(hDlg, (LPTSTR)"You ' re doing fine!", 

EndDialog(hDlg, FALSE); 

(LPTSTR)"Scanners", MB Ok); 

return TRUE; 

return TRUE; 


case ID SCANNER ADD: 

default: return TRUE; 

) 

DialogBox(hInst, MAKEINTRESOURCE(ADD DLG), 

break; 

hDlg, (DLGPROC)AddDlgProc); 

} 

ReadScannerRegistry(hDlg, ID SCANNER LIST); 

return FALSE; 

break; 

) /* AddDlgProc */ 

case ID SCANNER CONFIGURE: 


SendDlgItemMessage(hDlg, ID SCANNER LIST, 

BOOL ReadScannerRegistry(HWND hDlg, int iListID) 

LB GETTEXT, index, (LONG)(LPTSTRjlpEntry); 

( 

GetVendorModule(lpEntry, 1pBuffer); 

HKEY hKey; 

• 

DWORD i, status; 

if ((hLib = LoadLibrary(lpBuffer)) == NULL) 

CHAR cValueName[MAX STR LEN+1], cDataString[MAX STR LEN+1]; 

{ 

DWORD dwValueLen = MAX STR LEN, dwDataLen = MAX STR LEN; 

MessageBox(hDlg, "Couldn't find library!", 


"Scanners", MB OK); 

SendDlgItemMessage(hDlg, iListID, LB RESETCONTENT, 0, OL); 

break; 


) 

if ((status = RegOpenKeyEx(HKEY CURRENT USER, 

lpfn = GetProcAddress(hLib, “CPL ScannerConfigure"); 

"Control PanelWScanners", 0, KEY QUERY VALUE, &hKey)) 

(*lpfn)(hDlg, 0, (LPTSTRjlpEntry); 

!= ERROR SUCCESS) 

FreeLibrary(hLib); 

( 

break; 

/* "Scanners" key doesn't exist, create it */ 

case ID SCANNER REMOVE: 

RegCreateKeyEx(HKEY_CURRENT_USER, 

"Control Panel WScanners", 0, "\0", 

SendDlgItemMessage(hDlg, ID SCANNER LIST, 

REG OPTION NON VOLATILE, KEY ALL ACCESS | KEY WRITE, 

LB GETTEXT, index, (LONG)(LPTSTR)lpEntry) ; 

NULL, &hKey, &status); 

if (DeleteScannerRegistry(hDlg, IpEntry)) 

RegCloseKey(hKey) ; 

ReadScannerRegistry(hDlg, ID SCANNER LIST); 

EnableWindow(GetDlgItem(hDlg, ID SCANNER REMOVE), 0); 

break; 

EnableWindow(GetDlgItem(hDlg, ID SCANNER CONFIGURE), 0); 

default: 

return FALSE; 

) 

return TRUE; 


} 

for (i=0, status=ERROR SUCCESS; status==ERROR SUCCESS; i++) 

break; 

f 

} 

dwValueLen = MAX STR LEN; /* must reset max length */ 

return FALSE; 

dwDataLen = MAX STR LEN; /* must reset max length */ 

) /* ScannerDl gProc */ 

status = RegEnumValue(hKey, i, cValueName, SdwValueLen, 

^*********************************************************** 

NULL, NULL, cDataString, AdwDataLen); 
if (status == ERROR SUCCESS) 

** Routine: AddDlgProc - dialog box procedure for ADD DLG 

< 

*********************************************************** j 

ReplaceCommasWithTabs(cDataString) ; 

BOOL APIENTRY AddDlgProc(HWND hDlg, UINT msg, WPARAM wParam, 

SendDlgItemMessage(hDlg, iListID, LB ADDSTRING, 0, 

LPARAM 1Param) 

(long)(LPTSTR)cDataString) ; 
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Listing 1 continued 


} 

} 

RegCloseKey(hKey); 

SendDlgItemMessage(hDlg, iLi St ID, LB_SETCURS£L, 0, 0L); 
SendDlgItemMessage(hDIg, iLlstID, LB_GETTEXT, 0, 

(LONG)(LPTSTR)1pBuffer); 
iCap = GetVendorCapabilities(lpBuffer); 
if ((iCap & CPL_SCANNER_SUPPORT_CONFIGURE) == 0) 

EnableWindow(Get01gItem(hDlg, ID_SCANNER_CONFIGURE), 0); 
else EnableWindow(GetDlgltem(h01g, ID_SCANNER_CONFIGURE), 1); 
EnableWindow(GetDlgltem(hDlg, ID_SCANNER_REMOVE), 1); 

return TRUE; 

) /* ReadScannerRegistery */ 

_ **/ 

BOOL DeleteScannerRegistry(HWND hDlg, LPTSTR IpEntry) 

f 

HKEY hKey; 

HINSTANCE hLib = 0; 

FARPROC lpfn = 0; 

if (MessageBox(hDlg, "Remove the selected scanner driver?", 
“Scanners", MB_YESN0 | MB_ICONQUESTION) == IDNO) 
return FALSE; 

if (RegOpenKeyEx(HKEY_CURRENT_USER, 

"Control PanelWScanners”, 0, KEY_WRITE, &hKey) 

!= ERROR_SUCCESS) return FALSE; 

GetVendorValue(IpEntry, 1pBuffer); 

RegDeleteValue(hKey, lpBuffer); 

RegCloseKey(hKey); 

if ((iCap & CPL_SCANNER_SUPPORT_UNINSTALL) != 0) 

( 

GetVendorHodule(lpEntry, lpBuffer); 

if ((hLib = LoadLibrary(lpBuffer)) == NULL) return FALSE; 

lpfn = GetProcAddress(hLib, "CPL_ScannerUninstal 1 “); 

(*1pfn)(hDlg, 0, (LPTSTR)1pEntry); 

FreeLibrary(hLib); 

) 

return TRUE; 

) /* DeleteScannerRegistry */ 

/** _____ ** / 

BOOL WriteScannerRegistry(HWND hDlg, LPTSTR IpEntry) 

{ 

HKEY hKey; 

HINSTANCE hLib = 0; 

FARPROC lpfn = 0; 

i f (RegOpenKeyEx(HKEY_CURRENT_USER, 

"Control PanelWScanners", 0, KEY_WRITE, &hKey) 

!= ERROR_SUCCESS) return FALSE; 

GetVendorValue(l pEntry, 1 pBuffer); 

RegSetValueEx(hKey, lpBuffer, 0, (DWORD)REG_SZ, 

(LPBYTE)1pEntry, strlen(lpEntry)); 

RegCloseKey(hKey); 

iCap = GetVendorCapabilities(lpEntry); 
if ((iCap & CPL_SCANNER_SUPPORT_INSTALL) != 0) 

( 

GetVendorModule(lpEntry, lpBuffer); 
if ((hLib = LoadLibrary(lpBuffer)) == NULL) return FALSE; 
lpfn = GetProcAddress(hLib, "CPL_ScannerInstall“); 
(*lpfn)(hDlg, 0, (LPTSTR)1pEntry); 

FreeLibrary(hLib); 

) 

return TRUE; 

) /* WriteScannerRegistry */ 

/**.**/ 


CPl_ScannerConfigure(HWND, ULONG, LPTSTR) 
CPL_ScannerInsta1 1(HWND, ULONG, LPTSTR) 

CPL_ScannerUninstal1(HWND, ULONG, LPTSTR) 

#define CPL_SCANNER_SUPPORT_CONFIGURE 0x01 

Idefine CPL_SCANNER_SUPPORT_INSTALL 0x02 

#define CPL_SCANNER_SUPPORT_UNINSTALL 0x04 

By exporting these routines in the vendor-specific modules, 
scanner vendors can provide their own configuration, install, 
and uninstall code. 

All the information the scanner applet needs concerning a 
new scanner driver is specified in scanaplt. inf, which I have 
defined to have the following format. Remember to be careful 
v/ith case sensitivity in filenames. Under the NT file system 
(NTFS), SCANAPLT.INF is not the same file as scanaplt. inf\ 

[CPL_Scanner] 

Scanners=3 

Scannerl=Hewlett-Packard ScanJet lie, 

HPSCANAP.DLL,HPSCANIIC,7 
Scanner2=Hewlett-Packard ScanJet lip, 

HPSCANAP.DLL,HPSCANIIP,7 
Scanner3=ACME Scanner,ACMESCAN.DLL,ACME,6 

The Scanners entry specifies how many scanner drivers 
are included in this scanaplt. inf file. The ScannerN entries 
contain a comma-delimited string specifying all the information 


ANNOUNCING NEW 
IMAGE SDK PLUS !! 


Unique functions available ONLY from 
Black Ice Software. 

Read, write and print TIFF,PCX, GIF, TARGA, 
MS Metafile, Clipboard, DIB and the 
New ColorFax™ format 
Image Transformation:Antialiasing conversion, 
scaling color images, bilinear or cubic spline 
interpolation, skew image for OCR, rotation 1 degree, 
dithering,display DIB or DDB images, compress & 
decompress DIB, scrolling, utility functions, digitize 
ASCII text. Only $299.95 

ALSO NEW V4.0 TIFF SDK For Windows or DOS 
Features include NEW HIGH SPEED Group 3 & 
Group 4 fax file formats, (call for new benchmarks) 
IBM's MMR IOC A, decompress from memory, 
decompress from every repaint, LZW & Packbit 
compression,24 bit color images, chained images 
Contains over 50 functions. Only $299.95 

Call for FREE demo 
NO ROYALTIES 

BLACK ICE SOFTWARE, INC. 

113 RT. 122, Amherst, NH 03031 
Tel: (603) 673-1019 Fax: (603) 672-4112 
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the scanner applet needs for that particular scanner/driver. 
The first field is the description that will appear in the scanner 
applet’s listbox. The second field is the name of the vendor- 
specific module (DLL). The third field is a unique label that will 
be used to store the entire string in the Registry for later 
retrieval. The fourth field is a numerical value that is a logical 
OKing of all the capabilities that this vendor-specific DLL sup¬ 
ports. The maximum length of the entire string is 128 bytes. 
To add a new scanner driver, a vendor provides a 


Listing 1 continued 


BOOL ReadlnfFi1e(HWND hDlg, LPTSTR lpFilename) 

{ 

WORD wDrivers=0, i=0; 

static char 1pEntry[MAX_STR_LEN+1]; 

wDrivers = GetPrivateProfileInt( 

"CPL_Scanner”, "Scanners' 1 , 0, lpFilename); 

for (i=1; i <= wDrivers; i++) 

I 

wsprintf(lpBuffer, "Scanner%d“, i); 
GetPrivateProfileString("CPL_Scanner", lpBuffer, "0", 

1pEntry, MAX_STR_LEN, lpFilename); 
WriteScannerRegistry(hDlg, IpEntry); 

) /* for i */ 
return TRUE; 

) /* ReadlnfFi le */ 

j kk _____ kk j 

void ReplaceCommasWithTabs(LPTSTR IpEntry) 

{ 

int i; 

for (i=0; 1pEntry[i] != 1 \0 1 ; i++) 

if (1pEntry[i] == ',') 1pEntry[i] = '\t'; 

) /* ReplaceCommasWithTabs */ 

/**____★* f 

int GetVendorCapabilities(lPTSTR IpEntry) 

( 

LPTSTR lp - IpEntry + strlen(lpEntry) - 1; 

while (*lp != '\0‘ && *lp ! = 1 \t' && *lp != ',') lp—; 

return atoi(++lp); 

) /* GetVendorCapabilities */ 

/** . **/ 

void GetVendorModule(LPTSTR IpEntry, LPTSTR lpModule) 

f 

LPTSTR lpl = IpEntry, lp2 = lpModule; 

while (*1pi != '\0‘ && *lpl != '\t' && *lpl ! = ',') lpl++; 
lpl++; 

while (*lpl != '\0' && *lpl != '\t' && *1 pi ! = ',') 

*lp2++ = *lpl++; 

*lp2 * 1 \0'; 

) /* GetVendorModule */ 

/** _ ** / 

void GetVendorValue(LPTSTR IpEntry, LPTSTR IpValue) 

( 

LPTSTR lpl = IpEntry, lp2 * IpValue; 

while (*1pi 1= '\0‘ && *1 pi != '\t‘ && *lpl ! = ',') lpl++; 

1 pi++; 

while (*lpl != '\0' && *1 pi I- '\t' && *lpl ! = ',') lpl++; 
lpi ++ ; 

while (*lpl != '\0' S& *1 pi != '\t' && *1 pi ! = ',') 

*lp2++ = *lpl++; 

*lp2 • 1 \0'; 

) /* GetVendorValue */ 

/* End of File */ 


scanaplt.inf file and instructs the user to select the Add 
button in the scanner applet. 

Applet User Interface Design 

The Control Panel applet icon should, at a glance, convey 
clearly the category of device that it supports, so for the scan¬ 
ner applet I designed a fairly simple icon that resembles a 
typical desktop scanner. Microsoft has established a precedent 
by using somewhat muted colors in their standard applet 
icons — with so many icons stacked in a row, the Control 
Panel would resemble a comic strip if the icons were too 
flashy. In keeping with this precedent, I used only shades of 
gray to draw my scanner icon. Figure 1 shows the Windows 
NT Control Panel, including my scanner applet. 

I also tried to model the user interface of my scanner ap¬ 
plet after the standard Drivers applet. This helps make the 
applet look as if it really belongs in the Control Panel client 
area, rather than as if it had just been dropped there by some 
program (even though, of course, that is exactly what I am 
doing!). The common applet look calls for a listbox on the left 
side and buttons along the right side. Typically, you would 
include a Cancel button for easily closing the applet; a Help 
button to provide information on the scanner applet itself (not 
vendor-specific help); an Add button to add additional drivers; 
a Remove button to remove an existing driver-, and a button 


Listing 2 scanaplt.h — Header file for scanaplt.c 


I** _+* 

** SCANAPLT.H: Defines and Prototypes for SCANAPLT.CPL 
** Environment: Windows NT. 

** (C) Hewlett-Packard Company 1993. PLT. 

________ kk J 


/**-General Defines-**/ 

♦define IDNULL -1 

fdefine MAX STR LEN 128 

♦define NUM - SCANNER_APPS 1 

♦define ICO SCANNER - 999 


/**- Vendor Capability Flags -**/ 

♦define CPL_SCANNER_SUPPORT_CONFIGURE 0x01 

Idefine CPL_SCANNER SUPPORT INSTALL 0x02 

Idefine CPL_SCANNER - SUPPORT - UNINSTALL 0x04 

/**-.SCANNER DLG.**/ 

Idefine SCANNER_DLG ~ 4000 

Idefine ID SCANNER LIST 4001 

♦define ID - SCANNER~ADD 4002 

Idefine ID_SCANNER - REM0VE 4003 

Idefine ID_SCANNER_C0NFIGURE 4004 

Idefine ID_SCANNER_HELP 4005 

/**.ADD DLG.**/ 

Idefine ADD_DLG 4100 

Idefine ID EDITDRIVESRC 4101 

Idefine ID_ADD_HELP 4102 

/**-Prototypes for SCANAPLT.C-**/ 

LONG CALLBACK CPlApplet(HWND, UINT, LPARAM, LPARAM); 

BOOL API ENTRY ScannerDlgProc(HWND, UINT, WPARAM, LPARAM); 
BOOL API ENTRY AddDlgProc(HWND, UINT, WPARAM, LPARAM); 

/**- Entry-point for Scanner Specific Options -**/ 

UL0NG APIENTRY CPL_ScannerConfigure(HWND, UL0NG, LPTSTR); 
UL0NG APIENTRY CPL_ScannerInstal1(HWND, UL0NG, LPTSTR); 

UL0NG APIENTRY CPL_ScannerUninstall(HWND, UL0NG, LPTSTR); 

/* End of File */ 
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to provide vendor-specific features (usually called Configure or 
Setup). Figure 2 shows the dialog box for my scanner applet. 

Creating the Scanner CPL 

The source code for the sample scanner Control Panel ap¬ 
plet resides in scanaplt.c (Listing 1), scanaplt.h (Listing 2), 
scanaplt.rc (Listing 3), scanaplt.def (Listing 4), and 
scanaplt.mok (Listing 5). CPlApplet() contains a case state¬ 
ment for each of the eight messages sent by the Control 
Panel. This applet does not require special initialization or 
cleanup, so the only real action occurs during the CPL_NEUIN- 
QUIRE and CPL_DBLCLK messages. 

When the Control Panel sends the CPL_NEUINQUIRE mes¬ 
sage, it passes a pointer to a NEUCPLIN- 
FO structure in lParam2. It is the CPL's 
responsibility to completely and ac¬ 
curately fill in this structure, hlcon con¬ 
tains the handle of the icon that I want 
displayed in the Control Panel client 
area, and the szName string should con¬ 
tain the string to be displayed immedi¬ 
ately under the icon and in the Settings 
menu. The szlnfo string will appear in 
the status bar area when a user selects 
the icon. 

When the CPL_DBLCLK message is 
sent, I bring up the dialog box for the 
scanner applet, specifying ScannerDlg- 
Proc as the dialog box prodecure. 

During the UM_INITDIALOG message, the 
dialog procedure reads from the 
Registry and displays in the listbox any 
previously installed scanner drivers. 

Before explaining the procedure, how¬ 
ever, I want to describe how a scanner 
driver gets added to the scanner applet. 

When a user presses the Add 
button, the dialog box in Figure 3 is 
displayed. This dialog box allows the 
user to specify the path where 
scanaplt. inf can be found. Read- 
InfFile() parses scanaplt.inf 
using the private profile string APIs. 
WriteScannerRegistryO then stores 
the information strings found in 
scanaplt.inf in the Registry. This 
routine opens the Control 
Panel\Scanners subke y of the 
HKEY_CURRENT_USER key. The Control 
Panel key is where most Control Panel 
information is stored. I include several 
small support routines at the end of 
scanaplt.c to parse out individual 
fields from the comma-delimited string. 

Information is always stored in the 
Registry in the form of a value field, 
data type, and the actual data. I use 
the unique label in the information 
string as the value field and REG_SZ to 


indicate that the data is a nul l -terminated string. Finally, I 
store the information string itself as the data in the Registry. 
After a scanner has been added with the sample 
scanaplt. inf shown earlier, the Registry contains the follow¬ 
ing values in the HKEY_CURRENT_USER\Control Panel\Scan- 
ners key: 

HPSCANAPIIC:REG_SZ:Hewlett-Packard ScanJet lie, 
HPSCANAP.DLL,HPSCANIIC,7 
HPSCANAPIIP:REG_SZ:Hewlett-Packard ScanJet Up, 
HPSCANAP.DLL,HPSCANIIP,7 
ACME:REGSZ:ACME Scanner,ACMESCAN.DLL,ACME,6 


FINALLY, THERE ARE SOME 
BK NO-NO'S TO PRODUCING 
BO USER HELP. 

NO RTF 

MO FOOTNOTES^ 

MO HlODiM CfMMCtW 
M£SCAP£S£QU£MCf_< 


Creating end user help files 
can be a pretty negative 
experience for software 
developers. But pos¬ 
itive help is here. 

HELP-EASE, the 
help authoring editor, does 
more to simplify the process than any 
other product available. For use with 
new or existing projects, HELP-EASE 
automatically creates and maintains 
the help project file, so authors can 
focus on content. The software allows 


you to see text and graphics the 
way end users will see them. 
HELP-EASE enables you to 
import RTF and ASCII files 
and has a project wide data 
base for the easy establishment 
of hypertext links. What’s more, 
with HELP-EASE you don’t have to 
purchase or learn Microsoft WORD™. 

There's no other product like 
HELP-EASE. List price $495. Intro 
price $395* through August 21,1993. 
Includes one year of technical support. 


Call 404-368-0112. Or contact: 

Premiere Event Software 

P.O. Box 177, Norcross, GA, 30091 

Requires Microsoft Windows 3.1 ™ and Microsoft Help Compiler™ * Georgia residents include 6 % sales tax 
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SLATE jaSL ATE^SCRIPT 
Graphics S_PRINT 

Would Text and Graphic 
Printer support for over 850 
printers give you an edge? 

By including SLATE with Graphics, you 
can print Text and Graphics on over 850 
printers. Immediately! Painlessly! 

You can use SLATE in your product 
with no royalties. It gets you out of the 
printer support business. 

Make your product more functional 
and competitive by using SLATE'S 
advanced text features: 

• Output to parallel printers, serial printers, DOS 

files and Novell network printers, 

• Support proportional fonts and scalable fonts. 

• Set exact print positions. 

• Kerning, leading, underlining, and strike through. 

• Automatic character set conversion. 

• Print lines and shaded areas (laser printers only). 

SLATE with Graphics adds advanced 
graphic printing features: 

• Print images from the screen, PCX or TIFF files, 

or custom image systems. 

• Print lines and shaded areas on all printers. 

• Scale and Rotate printed image. 

• Print grey scale and color images. 

• Intermix text and graphics. 

SLATE is a C or Basic library of over 
170 text printing functions, a Database 
of over 850 printers, and End User 
configuration and testing programs. 
SLATE with Graphics adds over 60 
graphic printing functions. 

Would a User Configurable 
Report Writer give you a 
more competitive product? 

SCRIPT is a full featured Text 
Formatting library that can be 
incorporated into your application. 
SCRIPT uses SLATE as its printer 
driver. SCRIPT lets you merge text, 
data, and S_PRINT formatting 
commands from ASCII files and your 
application. 

Enhance your product by taking 
advantage of SCRIPT'S features: 

• Allow users to alter document format. 

• Set exact positions, center, right adjust, and 

decimal align. 

• Fill paragraphs from unformatted text. 

• Add lines, shaded areas, logos, signatures, etc. 

• Add commands and macros. 

Call or FAX now for a complete catalog 
and developer's guide for The 
Symmetry Group's printer support 
products. Order SLATE for $299, 

SLATE with Graphics for $448, or 
SCRIPT for $199 with our risk free, 30 
day return policy. 

The 800-346-3938 

POBox 26195 
Columbus, OH 43226, USA 
614-431 -2667 • FAX 614-431-5734 


Symmetry 


Finally, UriteScannerRegistryf) 
checks the capabilities field of the infor¬ 
mation string. If the CPL_SCANNER_SUP- 
PORT_INSTALL bit is turned on, I call 
CPL_ScannerInstall() in the DLL 
specified in the information string. 

Similarly, if a user selects “Remove,” 
DeleteScannerRegistryf) uses the 
value label in the information string to 
determine which value in the Registry 
to delete. In this case, if the CPL_SCAN- 
NER_SUPPORT_UNINSTALL bit is turned 
on in the capabilities field, I call 
CPL_ScannerUn ins tall () in the 
specified DLL. 

Whenever an entry in the listbox is 
selected, I check the capabilities value 
and determine whether or not to gray 
out the Configure button. If the user 
selects the Configure button, I call 
CPL_ScannerConfigure () in the 
specified DLL. This instructs the vendor- 
specific DLL to bring up its own dialog 
box and present its own configuration 
options. 

When the scanner applet is first 
launched, I enumerate all of the values 
in the Scanners key of the Registry and 
display them in the listbox. To keep this 
example simple, I also re-enumerate 
the Registry values whenever a scanner 
driver is added or removed. Rather than 
define a complicated method for storing 
all the fields for each installed scanner 
driver that maps into the listbox index, I 
use the simple trick of replacing com¬ 
mas with tabs and adding the entire 
string to the listbox. All fields except the 
description are safely tabbed out of the 
client area of the listbox, so users will 
never see them. This trick makes it very 
easy to retrieve information about a 
selected scanner driver. 


Windows NT Differences 

Don't forget that DLL entry points 
don't have to be named LibMainf) 
anymore; you can specify the DLL in¬ 
itialization function in the link state¬ 
ment of your makefile. Another impor¬ 
tant Windows NT difference is in the 
return values of LoadLibraryf). In Win¬ 
dows 3.x, LoadLibrary() returns a 
value between 0 and 32 if it fails. In 
Windows NT, LoadLibraryf) returns 
NULL on failures. You must call Get- 
LastErrorf) to determine the exact 
cause of the failure. 

Creating a Sample 
Vendor-Specific DLL 

The complete source code for a ven¬ 
dor-specific DLL template that uses the 
Hewlett-Packard scanners as examples 
resides on the code disk. Most of the 
source code is shown in hpscanap.c 
(Listing 6). By specifying a value of 7 in 
the scanaplt.inf file for these scan¬ 
ners, I declare that I want to provide 
configuration support and that I want to 
be notified if my scanner drivers are in¬ 
stalled or uninstalled. This requires ex¬ 
porting CPL_ScannerConfigure(), CPL_- 
Scannerlnstall (), and CPL_Scanner- 
Uninstallf). 

CPL_ScannerInstall() and CPL_- 
ScannerUninstall() just return TRUE in 
this simple example. Typically, for 
CPL_ScannerInstall (), you would 
copy any necessary driver files to disk, 
and update any configuration files or 
Registry entries. Likewise, for 
CPL_ScannerUninstall (), you would 
typically delete any files that you 
copied and remove your specific entries 
in configuration files or the Registry. 

A scanner vendor would typically 
use CPL_ScannerConfigure() to display 
a dialog box offering vendor-specific op¬ 
tions such as configuring the scanner 
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Listing 3 scanaplt.rc — Resource definitions for 
scanaplt.c 


/**__ _ ______** 

** SCANAPLT.RC: Resources information for SCANAPLT.CPL 
** Environment: Windows NT. 

** (C) Hewlett-Packard Company 1993. PLT. 

** ___________ **/ 

/**- Include Files-**/ 

linclude <windows.h> 

^include "scanaplt.h" 

ICO_SCANNER ICON SCANAPLT.ICO 

/**-add the standard version resource info-**/ 

/**.SCANNER DLG -.—.*/ 

$CANNER_DLG DIALOG LOADONCALL MOVEABLE DISCARDABLE 
20. 20, 220, 112 

STYLE DS_MODALFRAME | WS POPUP | WS VISIBLE | WS CAPTION | 
WS_SYSMENU 
CAPTION "Scanners" 

FONT 8, “Helv" 

BEGIN 

CONTROL "Installed Scanner Drivers:", IDNULL, "static", 

SS LEFT | WS_CHILD, 12. 10, 191, 8 
CONTROL "", 1D_SCANNER LIST, “listbox", LBS STANDARD | 
LBS_USETABSTOPS | WS TABSTOP | WS CHILD,” 

12, 20. 130, 78 

CONTROL "Close", IDOK, "button", BS_DEFPUSHBUTTON | 
WS_TABSTOP | WS CHILD, 154, 20, 54, 14 
CONTROL "AAdd...",”lD SCANNER_ADD, "button", 

BS_PUSHBUTTON | WS~TABSTOP”| WS_CHILD, 154, 36, 54, 14 
CONTROL "ARemove", ID~SCANNER REMOVE, "button", 

BS_PUSHBUTTON | WS _ TABSTOP”| WS_CH1LD, 154, 52, 54, 14 
CONTROL "AConfigure..7", ID_SCANNER_CONFIGURE, "button", 
BS_PUSHBUTTON | WS TABSTOP | WS_CHILD, 154, 68, 54, 14 
CONTROL "AHelp", ID SCANNER HELP, "button", 

BS_PUSHBUTTON | WS_TABSTOP | WS_CHILD, 154, 84, 54, 14 
END 

/**-Add... Dialog Box-*/ 

ADD_DLG DIALOG LOADONCALL MOVEABLE DISCARDABLE 30, 30, 257, 62 
STYLE DS_MODALFRAME | WS_P0PUP | WS VISIBLE | WS CAPTION | 

WS SYSMENU 

CAPTION "Add Scanner" 

FONT 8, "Helv" 

BEGIN 

CONTROL "Insert disk containing Scanner Driver in:", 
IDNULL, "static", SS_LEFT | WS_CHILD, 12, 18, 129, 8 
CONTROL "", ID EDITDRIVESRC, "edit", ES_LEFT | WS_B0RDER | 
ES AUTOHSCROLL | WS_TABSTOP | WS CHILD, 12, 32, 158, 12 
CONTROL "OK", IDOK, "button", BS_DEFPUSHBUTTON | 
WS_TABSTOP | WS_CH1LD, 194, 8, 52, 14 
CONTROL "Cancel", TdCANCEL, "button", 

BS_PUSHBUTTON | WS_TABSTOP | WS CHILD, 194, 24, 52, 14 
CONTROL "AHelp", ID_ADD_HELP, "button", 

BS PUSHBUTTON j WS_TABSTOP | WS CHILD, 194, 40, 52, 14 
END 


Listing 4 scanaplt.def - Linker definitions for 
scanaplt.c 


;SCANAPLT.DEF - module definition file for SCANAPLT.CPL 


LIBRARY 

ScanAplt 


CODE 

PRELOAD MOVEABLE 

DISCARDABLE 

DATA 

PRELOAD SINGLE 


EXPORTS 

CPI Applet 

@2 


ScannerDlgProc 

@10 


AddDlgProc 

@11 


Listing 5 scanaplt.mak — Makefile for scanaplt.c 


# Nmake macros for building Windows 32-Bit apps 
linclude <ntwin32.mak> 

all: scanaplt.dll 

scanaplt.obj: scanaplt.c 

$(cc) $(cflags) $(cvarsdll) $(cdebug) scanaplt.c 

scanaplt.res: scanaplt.rc scanaplt.h 
rc -r scanaplt.rc 

scanaplt.rbj: scanaplt.res 

cvtres -$(CPU) scanaplt.res -o scanaplt.rbj 

scanaplt.lib: scanaplt.obj scanaplt.def 
$(cvtobj) J(cvtdebug) scanaplt.obj 
lib32 -machine:$(CPU) \ 

-defiscanaplt.def \ 
scanaplt.obj \ 

-out:scanaplt.lib 

scanaplt.dll: scanaplt.obj scanaplt.def scanaplt.rbj scanaplt.lib 
$(1 ink) S(linkdebug) \ 

-base:OxlCOOOOOO \ 

-dll \ 

-entry:LibMain$(DLLENTRY) \ 

-out:scanaplt.dll \ 

scanaplt.exp scanaplt.obj scanaplt.rbj advapi32.1ib \ 

$(gui1ibsdl1) 


Or 
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RS232-Toolkit, SuperCom 2.1 
for DOS or Windows 
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transmission speed. 
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• DigiBoard PC/X, PC/Xe, PC/Xi support 
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Listing 6 hpscanap.c - Vendor-specific DLL template 


___ ** 

** HPSCANAP.C: Entry-points for the HP scanners. 

** Environment: Windows NT. 

** (C) Hewlett-Packard Company 1993. PLT. 

* *_____* * y 

/**- Include Files -**/ 

linclude <windows.h> 

#include “scanaplt.h" 
linclude "hpscanap.h" 


** Return: Return TRUE if successful, else return FALSE. 

*********************************************************** j 

ULONG APIENTRY CPL_ScannerConfigure(HWND hWndApplet, 

ULONG ulData, LPTSTR IpScannerTitle) 

( 

strcpy(lpTitle, IpScannerTitle); 

OialogBox(hInst, MAKEINTRESOURCE(CONFIGURE_DLG), 
hWndApplet, (DLGPROC)ConfigureDlgProc); 
return TRUE; 

) /* CPL_ScannerConfigure */ 


/** .Global Data.**/ 

HINSTANCE hlnst; 
char 1 pTitie[64]; 

j *********************************************************** 

** Routine: LibMain 

** Called by Windows when a DLL is loaded. Perform your 
** process or thread specific initialization tasks here. 
** Return: Return 1 if initialization successful. 

*********************************************************** j 

INT APIENTRY LibMain(HINSTANCE hModule, ULONG ulReason, 
LPVOID IpReserved) 

{ 

hlnst = hModule; 
return 1; 

} /* LibMain */ 

y*********************************************************** 
** Routine: CPL_ScannerConfigure 

** Entry-point for vendor-specific configuration options. 
** Called when "Configure..." selected for an HP scanner. 


One Party! 


386 PROLOG (Console] 


pSj File Edit Search Bun Options Window 


Why get bogged down with third party DOS extenders and 
C compilers, when all you want is to write 32-bit Windows 
programs? With LPA 386-PROLOG 2.0, you get everything 
you need to write really stunning applications: 

O True 32-bit stacks, heaps, programs & data 
O Fully programmable dialogs, menus Se windows 
O High level access to the GUI and operating system 
O Two-way data exchange through DLLs 

Hot to mention the integrated source level debugger, 
multi-file program editor, incremental and optimising 
compilers, and full Prolog predicate library. 

All this, and much more, without the need to buy any 
third party DOS extenders or C compilers. 

386-PROLOG is your one party, 32-bit applications 
development environment for Windows 3.1! 



IUJL14.W 

1 l/r~i i 

PROLOG 


fain tki party! 
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Logic Programming Associates Ltd 
Studio 4, RVPB, Trinity Road, London, SWI8 3SX, England 
Tel: (US Toll Free) 1-800-949-7567, (Int) +44 81 871 2016 
Email: lpa@cix.compulink.co.uk - CompuServe: 100135,134 
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y*********************************************************** 
** Routine: CPL_ScannerInstal1 

** Scanner Applet will call if user adds an HP scanner 
** (and capabilities indicate that install is supported). 
** Return: Return TRUE if successful, else return FALSE. 

★ A********************************************************* J 

ULONG APIENTRY CPL_ScannerInstal1(HWND hWndApplet, 

ULONG ulData, LPTSTR IpScannerTitle) 

{ 

/* copy/create files, add custom entries to registry */ 
return TRUE; 

) /* CPL_ScannerInstall */ 

/*** *************** ***************************************** 
** Routine: CPL_ScannerUninstall 

** Scanner Applet will call if user removes an HP scanner 
** (and capabilities indicate uninstall is supported). 

** Return: Return TRUE if successful, else return FALSE. 
***********************************************************/ 
ULONG APIENTRY CPL_ScannerUninstal1(HWND hWndApplet, 

ULONG ulData, LPTSTR IpScannerTitle) 

{ 

/* delete files, remove custom entries from registry */ 
return TRUE; 

} /* CPL_ScannerUninstall */ 

/*********************************************************** 

** Routine: ConfigureDlgProc 

** Dialog box procedure for CONFIGURE_DLG 

★ ★★★★★★★★★★★★★★★★★★Hr*************************************** j 

BOOL APIENTRY ConfigureDlgProc(HWND hDlg, UINT msg, 

WPARAM wParam, LPARAM IParam) 

{ 

switch (msg) 

( 

case WM_INITDIALOG: 

SetDlgItemText(hDlg, ID_CONFIG_SCANNER, lpTitle); 
if (strstr(lpTitle, "lie") == NULL) 

EnableWindow(GetDlgItem(hDlg, ID_CONFIG_CAL), 
FALSE); 
return TRUE; 

case WM_COMMAND: 
switch(wParam) 

( 

case ID_CONFIG_DRV: 

/* add code for configuring the drivers! */ 
MessageBox(hDlg, (LPTSTR)"Configured!", 

(LPTSTR)"HP Scanner Configuration", M8_OK); 
return TRUE; 

case ID_CONFIG_TEST: 

/* add code for testing the scanner */ 
MessageBox(hDlg, (LPTSTR)"Tested!", 

(LPTSTR)"HP Scanner Configuration", MB_OK); 
return TRUE; 

case ID_CONFIG_CAL: 

/* add code for doing color calibration */ 
MessageBox(hDlg, (LPTSTR)"Calibrated!", 
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driver and performing scanner diagnostics. Even though I use a 
single DLL to support two different scanners, I can use the 
string passed in to CPL_ScannerConfigure() to determine 
which scanner was specified. For example, if the ScanJet lip 
was specified, I gray out the Color Calibration button, since 
this is a gray-scale scanner. Figure 4 shows the dialog box for 
my vendor-specific DLL. 

Adding a CPL 

There are several ways to register an applet with the Con¬ 
trol Panel, and since there is some debate about the order in 
which the Control Panel performs its search, you should not 


Listing 6 continued 


(LPTSTR)"HP Scanner Configuration", MB_0K); 
return TRUE; 

case ID_CONFIG_HELP: 

/* call WinHelp with HLP file and topic */ 
MessageBox(hDlg, (LPTSTR)"You're doing fine! 1 ', 
(LPTSTR)"HP Scanner Configuration", MB_0K); 
return TRUE; 

case IDOK: 

EndDialogfhDlg, TRUE); 
return TRUE; 

default: return TRUE; 

) /* switch on wParam */ 
break; 

} /* switch on msg */ 
return FALSE; 

) /* OptionsDlgProc */ 

/* End of File */ 


Configure 


Configuration options for the: 
Hewlett-Packard ScanJet lip 


Driver Configuration 

T 7. . 

Scanner Xest 

Color Calibration 



Figure 4 Vendor-specific DLL dialog box 


rely too heavily on the load order of your applet. The Control 
Panel searches for applets in the following locations and in 
roughly this order: 

• The Control Panel first loads the standard applets located in 
main.cpl. 

• The Control Panel then checks the MMCPL key of the 
HKEY_CURRENT_USER key in the Registry (in windows 3.x, 
this information was contained in the [MMCPL] section of 
control.ini). This may be the best place to specify your 
applet if the CPL has other functions besides supporting 
Control Panel applets. 

• The Control Panel next looks for *.cpl files in the directory 
where control.exe is located. 

• Finally, the Control Panel looks for any files with the *.cpl 
extension in the Windows NT System directory 
(winnt\system32). 

Be sure to use the standard API functions, such as GetSystem- 
DirectoryO, to locate the System directory. 

Since I am not particularly concerned about the order that 
my scanner applet loads, for this example I chose the simplest 
method — method 4. To register an applet this way, I need 
only rename my .dll to .cpl and copy it to the Windows NT 
System directory. 

Starting a Control Panel Applet 

There are three ways to start a Control Panel applet: 


Pearl Software presents WinEmacs 


Emacs for Windows 


WinEmacs Is a fully functional Windows 3.1. version of the 
industry standard program editor Gnu Emacs, version 19*3* 
WinEmacs is available with all Gnu Emacs source code. WinEmacs 
is fully compatible with the Lucid Inc. Unix version of Gnu Emacs. 

WinEmacs retains all the Emacs features you are used to: 


Plus WinEmacs has these extended features: 


You can try the demo version of WinEmacs without cost by contacting Pearl 
Software at pearl@netcom.com (e-mail) (510) 273-9795 (voice) or (510) 839-9820 
(fax). If you decide to use it, please register for technical support from Pearl ($199). 
This will entitle you to all upgrades (NT version soon!) for one year, and access to our 
BBS which posts bug fixes and full Emacs source code.. 

WE ALSO PROVIDE EMACS CONSULTING SERVICES 

Pearl Software, 320 Lenox Ave., Oakland, CA 94610 


• Clipboard support 

• Scroll bars 

• DDE and OLE support 

• Binds any arbitrary combination of a 
key and key modifiers to Emacs Lisp 
code 


• Separate buffers in different windows 

• Menu and drop-down menu bar 

• Multiple font-size and type support 

• Cut and paste mouse support 

• Support for text and Binary files 

• Support for foreign keyboards 

How you can obtain WinEmacs 


• Syntax expansion and indenting 

• Begin/end structure and brace 
matching 

• Word wrap and full justification 

• Runs programs from within editor 

• Configurable key bindings to arbitrary 
Emacs Lisp functions 

• Compatibility with UNIX .emacs 
configuration tables 

• Mode line 

• Huge library of Emacs Lisp for other 
extensions 


• Emacs Lisp Extension Language 

• Hypertext help, on-line manual 

• Line, block, character marks 

• Full undo and redo 

• Multiple buffers 

• Edits arbitrarily large files 

• Regular expression search/replace 

• Incremental search 

• Procedure tagging with completion for C, 
C++, Pascal, Lisp, and many others 


July 1993 


Windows/DOS Developer’s Journal — Page 47 
































• A user can open the Control Panel and start an applet by 
double-clicking the applet icon or by choosing the name of 
the applet in the Settings menu. 

• A user can open an applet by running control.exe with 
the name of the applet as a command-line parameter. 
When the Control Panel applet closes, the Control Panel 
automatically closes. An application can accomplish the 
same thing by using the following line of code: 

WinExec("control.exe scanaplt", SW_SH0WN0RMAL) 

• An application can send a m_CPL_LAUNCH message to the 
Control Panel while the Control Panel is running. When the 
applet closes, the Control Panel sends back a 
UM_CPL_LAUNCHED confirmation message and then closes 
automatically. (Refer to the code fragment in Figure 5 for 
an example of starting a Control Panel applet using this 
method.) 

Where to Go from Here 

This sample CPL and vendor-specific module are really in¬ 
tended to be used as a template and to help flush out some 
of the specific development tasks and issues involved in writ¬ 
ing CPLs. To keep the sample as brief and simple as possible, I 
do very little error checking. In practice, though, the scanner 
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CPL should copy over the vendor-specific module when it per¬ 
forms an “Add” to ensure that it can be found when 
CPL_ScannerInstall () is called! A better solution would also 
allow vendors to specify NONE in place of the module name if 
they did not want to support configure, install, and uninstall. 
And, of course, additional capabilities could be added. Finally, 
it is always a good idea to add the standard version structures 
to your resource file so that other applications can obtain in¬ 
formation about your DLL. 

Although this is a 32-bit native Windows NT sample, the 
Control Panel interface has changed very little from Windows 
3.x, so it should be a fairly simple job to port this sample to 
Windows 3.x. In that case, of course, you would use *.ini 
files rather than the Registry for storing information. 
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Microsoft Corp. Preliminary Win32 Software Development Kit 
for Windows NT. Redmond, WA: October 1992. 

Microsoft Corp. Preliminary Windows NT Device Driver Kit. Red¬ 
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Figure 5 Code fragment for starting Control Panel 
applet 


linclude <windows.h> 
linclude <cpl.h> 

HWND hCplWnd = NULL; 

WORD wStart = FALSE; 

HGLOBAL hName; 

LPSTR lpName; 

/* allocate a shareable memory block for applet name */ 
hName = GlobalA1loc(GMEM_MOVEABLE, 9); 
if (hName «« NULL) return FALSE; 
lpName = GlobalLock(hName); 
strcpy(lpName, "Scanners"); 

GlobalUnlock(hName); 

/* see if Control Panel already running */ 
if ((hCplWnd « FindWindow("CtlPanelClass", 

"Control Panel")) -- NULL) 

{ 

/* Control Panel not running, so start it now */ 
WinExec("control.exe", SW_SH0WNA); 
hCplWnd = FindWindow("CtlPanel Cl ass", "Control Panel"); 
if (hCplWnd == NULL) 

( 

Global Free(hName); 
return FALSE; 

} 

wStart = TRUE; 

) 

/* start applet, I'll get back WM_CPL_LAUNCHED message */ 
SendMessage(hCplWnd, WM_CPL_LAUNCH, (WPARAM)hMyWnd, 
(LPARAM)lpName); 

/* if I opened Control Panel, close it now */ 
if (wStart) SendMessage(hCplWnd, WM_CL0SE, 0, 0); 
GlobalFree(hName); 
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Visual Implementation: 
Shadowed Popup Windows 

Steven Palmer 


Microsoft's The Windows Interface: An Application Design Guide discusses read¬ 
only popup text fields, such as those that WinHelp uses. Although the book is typi¬ 
cally vague on how it's done, WinHelp always uses a popup window with a shadow 
(see Figure 1) for read-only popup text fields. The window’s shadow provides a visual 
clue that this is not an ordinary window (the window has captured the mouse and 
the keyboard, and any input event causes the window to disappear). The Windows 
API does not directly support shadowed windows, so if you want to use this visual 
element in your application, you will have to roll your own code. This article explains 
how to implement shadowed popup windows. 

Design 

Before I decided to implement my version of the shadowed popup window, I 
looked at alternative schemes. After all, there is little point in reinventing the wheel. 
An example produced by Microsoft in the WINSDK forum on CompuServe turned out 
to be disappointing. The code worked, but it was too inflexible and could not be 
easily encapsulated. The portion of the code that painted the client area of the 
shadowed popup window was merged with the same code that painted the non¬ 
client regions. 

Encapsulation is important to the crafting of reusable code. Code that is tightly 
bound to one application cannot easily be moved to another — to do so requires 
major engineering, at the cost of significant programmer time. I designed the code in 
spopup.c (Listing 1; Listing 2, spopup.h, is the header file) to provide a simple inter¬ 
face to two levels of functionality. At the lowest level, you can call RegisterSPopup- 
Classf) if you just want to be able to create windows that have a shadow. Another 
function, CreateSPopupO, offers a simpler method of creating the popup window 
than calling CreateUindow() directly. A higher-level function, PopupText(), handles 
the common case of displaying read-only text in a shadowed popup window. 

RegisterSPopupClass () 

RegisterSPopupClass() creates a new window class named “spopup" and 
returns a non-zero value if the class was registered without errors. With the class 
registered, you can create windows using the new class style; its internal window 
procedure, SPopupWndFn() (discussed later), takes care of drawing the window bor¬ 
der and shadow for you. 

After calling RegisterSPopupClass() , you can pass CreateUindowf) a class name 
of spopup to create a shadowed window. However, you may prefer to use 
CreateSPopupO , which calls CreateUindowf) , but only requires a subset of the 
CreateUindowf) parameters. This reduces the amount of work required to create 
shadowed popup windows. 


Steven Palmer is the Chief Software Engineer for LJ Technical Systems Ltd, a British 
firm developing Computer-Aided Training systems for electronics and microelectronics 
students. He may be contacted on CompuServe.- 100031,504. 
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As you can see in Listing 1, 
CreateSPopupO is very simple. You 
might wonder, though, why it calls 
UpdoteUindow() after calling Create- 
Uindowf) to create the popup window. 
The reason is that I wanted the popup 
window to be visible before 
CreateSPopupO returned. After 
CreateUindow() has returned, the Win¬ 
dows message queue will contain mes¬ 
sages directing the window to paint its 
client area. These messages will not be 
processed until the next cycle through 
GetMessage () IDispatchMessage () , s o 
any text drawn in the window before 
then will be erased. UpdateWindowf) 
forces all outstanding paint messages to 
be removed from the queue and hand¬ 
led so that the window is visible and 
empty when CreateSPopupO returns. 

The SPopup Window Procedure 

All messages relating to all windows 
created with the spopup class are 
directed to SPopupUndFnf) , because 
RegisterSPopupClass() makes this the 
default window procedure for the class. 
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finclude <window$.h> 
finclude “spopup.h" 

LRESULT _export CALLBACK SPopupWndFn( HWND, UINT, WPARAM, LPARAM ); 

#define SPOPUP_HAXWIDTH 400 

static irt aPattern[] * ( OxAA, 0x55, OxAA, 0x55, 

OxAA, 0x55, OxAA, 0x55 ); 

BOOL FAR PASCAL RegisterSPopupClass( HANDLE hlnst ) 

{ 


WNDCLASS wc; 


= LoadCursor( NULL, IDC_ARROW ); 
= NULL; 

= NULL; 

= "spopup"; 

= (HBRUSH)( COLOR_WINDOW + 1 ); 

= hlnst; 

= CS_HREDRAW | CSJ/REDRAW; 

= SPopupWndFn; 

= 0 ; 

= 0 ; 


wc.hCursor 
wc.hlcon 
wc.lpszMenuName 
wc.lpszClassName 
wc.hbrBackground 
wc.hlnstance 
wc.style 
wc.lpfnWndProc 
wc.cbClsExtra 
wc.cbWndExtra 
if( !RegisterClass( Awe ) ) 
return( FALSE ); 
return( TRUE ); 


HWND FAR PASCAL CreateSPopup( int x, int y, int cx, int cy, 

HWND hwnd, HANDLE hlnst, void FAR * IParam ) 

{ 

HWND hwndPopup; 

DWORD dwStyle = OL; 

if( hwnd ) 

dwStyle = WSCHILD; 
else 

dwStyle = W$_P0PUP; 

hwndPopup = CreateWindow( "spopup", NULL, 
dwStyle, x, y, cx, cy, hwnd, 

NULL, hlnst, IParam ); 

ShowWindow( hwndPopup, SW_SH0WN0ACTIVATE ); 

UpdateWindow( hwndPopup ); 
return( hwndPopup ); 

} 

void FAR PASCAL PopupText( HWND hwnd, int x, int y, LPSTR IpszText ) 

{ 

HWND hwndPopup; 

HANDLE hlnst; 

RECT rc; 

BOOL fDone; 

MSG msg; 

HDC hdc; 

hdc = CreateDC( “DISPLAY", NULL, NULL, NULL ); 

Select0bject( hdc, GetStockObject( SYSTEM_FONT ) ); 

SetRect( &rc, 0, 0, SPOPUP_MAXWIDTH, 0 ); 

DrawText( hdc, IpszText, -1, Arc, 

DT_NOPREFIX|DT_WORDBREAK|DT_CALCRECT ); 
rc.right += 10; 

DeleteDC( hdc ); 

hlnst « GetWindowWord( hwnd, GWW_HINSTANCE ); 
hwndPopup = CreateSPopup( x, y, 

rc.right + SPOPUP_SHADOWWIDTH * 3, 
rc.bottom + SPOPUP_SHADOWHEIGHT * 3, 
hwnd, hlnst, NULL ); 
hdc » GetDC( hwndPopup ); 

OffsetRect( Arc, SPOPUP_SHADOWWIDTH, SPOPUP_SHADOWHEIGHT ); 
DrawText( hdc, IpszText, -1, Arc, 

DT_WORDBREAK|DT_NOPREFIX ); 

ReleaseDC( hwndPopup, hdc ); 


II 


SetCapture( hwndPopup ); 

for( fDone = FALSE; !fDone; ) 

if( PeekMessage( Amsg, NULL, 0, 0, PM_REM0VE ) ) 
if( msg.message == WM_KEYDOWN || 
msg.message == WM_SYSKEYDOWN 
msg.message == WM_LBUTT0ND0WN 
msg.message == WM_MBUTT0ND0WN 
msg.message == WM_RBUTT0ND0WN ) 
fDone = TRUE; 
else { 

TranslateMessage( Amsg ); 
DispatchMessage( Amsg ); 

) 

ReleaseCapture(); 

DestroyWindow( hwndPopup ); 


LRESULT _export CALLBACK SPopupWndFn( HWND hwnd, 

UINT message, WPARAM wParam, LPARAM IParam ) 

f 

static HBITMAP hbm = NULL; 
static HBRUSH hbr = NULL; 
static int nUsage = 0; 

switch( message ) 

{ 

case WM_NCCREATE: 

if( nUsage++ == 0 ) { 

hbm = CreateBitmap( 8, 8, 1, 1, aPattern ); 
hbr = CreatePatternBrush( hbm ); 
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The window procedure uses two graphics objects, a bitmap 
pattern and a patterned brush, to paint the shadow. Because 
there may be more than one popup window on the screen at 
once, it avoids creating more than one instance of these ob¬ 
jects, which would be wasteful and unnecessary. SPopupUnd- 
Fn() increments a counter ( nUsage ) each time it receives a 
WM_NCCREATE message and decrements it at each 
UMNCDESTROY message. The function creates the pattern and 
brush it needs when the counter is zero and frees them when 
it returns to zero (which indicates that the last popup window 
has been destroyed). 

UM_NCCALCSIZE may be unfamiliar to most Windows 
programmers, despite having been around since Windows 2.x. 
Windows sends this message to compute the size of the win¬ 
dow client area. By default, the code in DefUindowProc() 
does this automatically; it takes the size of the window, as 
specified in the original CreateUindouf) call, then adjusts it 
for any borders, captions, scroll bars, or menu bar. However, 
the shadowed popup window has an extra decoration — the 
shadow — which is not a standard Windows style. Therefore, 
SPopupUndFn() traps the UM_NCCALCSIZE message and does 
its own computation. IParam points to a RECT structure that 
defines the exterior size of the window. From this structure, 
SPopupUndFn() subtracts the width and height of both the 
border and the shadow. 
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The bulk of SPopupUndFn() is concerned with drawing the 
window non-client areas. When Windows needs to repaint a 
window, it sends two paint messages in succession: 
mjCPAINT, followed by UM_PAINT. The m_NCPAINT message 
directs the owner of the window to draw the non-client por¬ 
tions — typically the borders, captions, and scroll bars while 
MM_PAINT handles the client area. Since SPopupWndFn () is not 
concerned with the client area, it processes only the 
WMJCPAINT message. 


Listing 1 continued 


) 

break; 

case WM_NCDESTR0Y: 

if( -nUsage == 0 ) { 

Delete0bject( hbm ); 

DeleteObject( hbr ); 

) 

break; 

case WMNCCALCSIZE: ( 

LPRECT lpCIRc = (LPRECT) IParam; 

lpClRc->left += 1; 
lpClRc->top += 1; 

lpClRc->right -= SPOPUP_SHAD0WWIDTH + 1; 
lpClRc->bottom -= SP0PUP_SHAD0WHEIGHT + 1; 
break; 

) 

case WMJICPAINT: { 

RECT rc; 

HDC hdc; 

HBRUSH hbrFrame; 

HBRUSH hbrOld; 

hdc = GetWindowDC( hwnd ); 

GetWindowRect( hwnd, &rc ); 
rc.right — rc.left; 
rc.bottom -= rc.top; 
rc.top = 0; 
rc.left = 0; 

Unrealize0bject( hbr ); 

hbrOld = Select0bject( hdc, hbr ); 

PatBlt( hdc, rc.left + SP0PUP_SHAD0WWI0TH, 
rc.bottom - SP0PUP_SHAD0WHEIGHT, 
rc.right - SP0PUP_SHADOWWIDTH, 
SP0PUP_SHAD0WHEIGHT, 0xA000C9 ); 

PatBlt( hdc, rc.right - SP0PUP_SHAD0WWIDTH, 
rc.top + SP0PUP_SHAD0WHEIGHT, 
$P0PUP_SHAD0WWIDTH, 
rc.bottom, 0xA000C9); 

Select0bject( hdc, hbrOld ); 

hbrFrame = CreateSolidBrush( 

GetSysColor( C0L0R_WIND0WFRAME ) ); 
rc.right -= SP0PUP_SHAD0WWIDTH; 
rc.bottom -= SP0PUP_SHAD0WHEIGHT; 

FrameRect( hdc, &rc, hbrFrame ); 

Delete0bject( hbrFrame ); 

ReleaseDC( hwnd, hdc ); 
break; 

) 

I 

return( DefWindowProc( hwnd,message, wParam, IParam ) ); 

) 

/* End of File */ 
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To draw in the non-client area of a window, you must call 
GetUindowDCf) ; you can't use GetDC() because the device 
context it returns only includes the client area of the window. 

To draw the shadow, SPopupUndFnf) uses PatBlt() to 
paint a dotted rectangle over the current background image. 
This dotted rectangle is actually the brush that SPopupUndFn() 
created when it processed the first UM_NCCREATE message. The 
last parameter to PatBlt() is a raster operation code that 
forces the background to appear through the white holes in 
the brush, giving the shadow a semblance of transparency. In 
other words, the user can partially see through the shadow to 
what was on the screen before the popup appeared, even 


Listing 2 spopup.h 


/* Shadow Dimensions */ 

Idefine SPOPUP_SHADOWWIDTH 16 

Idefine SPOPUP SHAD0WHE1GHT 16 


BOOL FAR PASCAL RegisterSPopupClassf HANDLE ); 

HWND FAR PASCAL CreateSPopupf int, int, int, int, 
HWND, HANDLE, void FAR * ); 
void FAR PASCAL PopupTextf HWND, int, int, LPSTR ); 

/* End of File */ 


though the shadow is actually just part of the non-client 
region of the popup window. 

A Read-Only Popup Window 

The most common use of shadowed popup windows is to 
display a brief message and wait for the user to press a key 
or mouse button before removing it from view. The best ex¬ 
ample of this appears in the Windows Help engine. If you run 
Windows Help using the standard help screen and click on a 
dotted-underlined word, a window pops up showing the 
definition of that word. This window is visually distinguishable 
from other popup windows in two ways: the shadow and the 
absence of any buttons. To remove the window, you simply 
click anywhere on the screen or press a key. I include another 
interface function, PopupText(), to provide this functionality. 
PopupText() takes only four parameters and handles the 
disks of drawing the shadowed popup window and detecting 
the mouse button or key presses. 

Because PopupTextO computes the size of the popup win¬ 
dow based on the amount of text being displayed, it always 
uses the system font. It uses DrawText() to precompute the 
dimensions of the rectangle that contains the text, and adjusts 
the dimensions to add a border. To determine the dimensions 
before the window is created, I create an artifical display con¬ 
text based on the screen resolution. This is a good technique 
for computing text width and height where no window is 
available. 


Trapped in a DOS BOX? 

Now, for the first time ever, Windows-enable any DOS program! 


with WINGate ® any DOS program can now fully control and seamlessly integrate 
with all Windows services and applications directly from a DOS box! Imagine the 
power of using your DOS programs as if they were Windows applications. 

>- Launch and terminate any DOS or Windows pmgram from your DOS box. 

)► Read and write data to the Windows Clipboard directly from your DOS pmgram. 

> Deliver DDE Execute and Poke commands from your DOS box directly to a 
Windows server as if you were a Windows DDE client to achieve unlimited 
extensions under Windows. 

WINGate* transforms the Windows environment into a 
true Client/Server platform for fully integrated application 
development. 

>- DOS and Windows, IB and 32-bit, real and protected mode 
applications can be used as either clients or servers. This capability 
effectively shatters the 640K barrier. You can split your DOS applica¬ 
tion into two or more DOS boxes (or regions) and communicate 
amongst them as required. 

The basic WINGate * Developers Kit is available for 
Windows 3.1 Enhanced Mode and sells for $295. 

1-800-WINGate Call now to secure your DOS investment and 
9 4 6-4 183 lo order your Developers Kit! 

MITech Inc. High St. Court, Suite 301 Morristown, NJ 07960 201-984-0070 

Clipper b a regstered trademark d Computer Associates Word Perfect is 3 registered trademark of Word Perfect Cap. Lotus s a regrsteredtrademark 
j ^ of Lotus Development Corp. Excel is a registered trademark o!Microsoft Corporation WINGate is a registered trademark of MITech Inc 



July 1993 


□ Request 162 on Reader Service Card □ 


Windows/DOS Developer’s Journal - Page 53 

















After displaying the popup window, PopupText() then sits in 
a tight loop, inspecting the Windows message queue until it sees 
a key or mouse-down event To ensure that the user cannot 
shift the focus to another window, it uses SetCapturef) to direct 
all mouse events to itself, regardless of where the mouse is on 
the screen. Any other messages are simply filtered through. Note 
that PopupText() does not contain any logic to repaint its win¬ 
dow text — it knows its window cannot be covered because no 
other window can get the input focus. Under Windows NT, how¬ 
ever, SetCapturef) does not keep the user from activating 
another application, so you might have to make PopupText() 
more complicated to handle that case. 

Crafting Your Own Popup Windows 

Although PopupTextf) takes much of the work out of 
drawing popup windows, it is limited in that it can only dis¬ 
play text and then only in the system font. For most purposes 
this is adequate. But if you prefer to mix text and graphics, or 
change the font, you will need to do a bit more work. 

Figure 2, taken from the test program supplied on the code 
disk, demonstrates how to draw both an icon and Courier text 
in the same window. The code is actually quite simple; most 
of it is concerned with actually drawing in the window. 
Towards the end, a SetCapture() call captures all mouse 
events to the parent window of the popup window. The Set- 
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Focus () that follows is necessary; otherwise, the popup win¬ 
dow would keep the focus and the parent window would not 
receive any keyboard messages. 

Testing 

A sample application that demonstrates the shadowed 
popup windows is included on the code disk. As Figure 1 
shows, when you run the application, you will see a single 
pull-down menu with five options. The first three options on 
the menu demonstrate the use of the PopupTextf) function 
to draw a variety of text strings in a shadowed popup win¬ 
dow. The last option uses CreateSPopupf) to create the 
popup window and paints the window itself. This way, the 
user can mix graphics and text in the same window. The last 
option exits the application. It is important to note that Figure 
1 was created by combining several screen shots to show all 
the variations —normally only one shadowed popup window 
can appear at a time, and you could not access the menu 
while a popup was displayed. 

Conclusion 

Shadowed popup windows receive scant attention in the 
Microsoft Application Design Guide. The most common use for 
such windows is to show brief explanatory text, usually when 
the user clicks on an object on the screen. This is the approach 
that I recommend, since a proliferation of shadowed popup win¬ 
dows in various contexts can only serve to confuse the end user. 
If you are feeling ambitious, try replacing the UM_NCPAINT code 
with code to draw a speech bubble (as seen in Lotus Organiser). 
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Figure 2 Mixing text and graphics in a shadowed 
popup 


case IDMJJSRPOPUP: { 

RECT rc; 

HANDLE hlcon; 

HFONT hFontOld; 

HDC hdc; 

hwndPopup = CreateSPopup( 50, 50, 400, 70, 
hwnd, hlnst, NULL ); 

GetClientRect( hwndPopup, &rc ); 
hdc = GetDC( hwndPopup ); 
hlcon = LoadIcon( hlnst, “TEST" ); 
DrawIcon( hdc, 10, 10, hlcon ); 

SetRect( &rc, 60, 10, 380, 50 ); 
hFontOld = Select0bject( hdc, 

GetStock0bject( ANSI_FIXED_F0NT ) ); 
DrawText( hdc, szSPopupInfo, -1, &rc, 
DT_W0RDBREAK|DT_N0PREFIX ); 
Select0bject( hdc, hFontOld ); 

ReleaseDC( hwndPopup, hdc ); 

SetCapturef hwnd ); 

SetFocusf hwnd ); 
break; 
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Buffered Redrawing 


Bruce Graves 


Several windowing environments, such as NeXTSTEP and some implementations 
of X Windows, implement a feature I'll call "buffered redrawing." With buffered 
redrawing, the system maintains a copy of each window's contents in an individual 
buffer. As windows are covered and uncovered, the system repaints their interiors 
automatically by copying data from the corresponding buffers. The programs that 
own the windows don't get involved until a window changes size or its contents are 
modified. 

The convenience of buffered redrawing isn't free: it requires a lot of memory, 
especially when used for large windows on displays with lots of colors (which is why 
systems that implement it usually allow programs to disable it if it isn't required). 
However, for programs that display images generated with ray-tracing, fractals, bit¬ 
map scaling or rotation, or any other type of CPU-intensive calculations, buffered 
redrawing can provide an impressive performance boost. 

Unfortunately, Microsoft Windows doesn't support buffered redrawing directly. 
More than one programmer (myself included) has been sidetracked by the window 
class style CS_SAVEBITS, which does save bits, but not the bits inside a specific 
window. Instead, CS_SAVEBITS tries to keep a copy of the area behind a window 
(such as a popup dialog window), so that when the window disappears, any win¬ 
dows that it overlapped won't have to process UM_PAINT messages. This can be 
useful at times, but it's not as flexible as a general buffered redraw capability. 

Buffer Your Own 

As it turns out, buffered redrawing isn't very difficult to implement under Win¬ 
dows. The idea is that whenever a window changes size, you allocate a bitmap the 
same size as the window and render the window's image in both the bitmap and 
the window itself. Then, to respond to UM_PAINT messages, you can simply BitBlt() 
from the bitmap onto the screen. Rendering the image simultaneously in the buffer 
and the window is important - otherwise, the user has to stare at a blank window 
until all the drawing in the buffer is complete and a BitBlt() occurs. 

The C++ program in Listings 1 through 6 demonstrates buffered redrawing in 
action. The program is based on Borland’s ObjectWindows Library (OWL) for brevity, 
though buffered redrawing can be implemented in any programming language that 
provides access to the Windows API and allows you to respond to messages like 
m_SIZE and MJAINT. 

winbuf.h (Listing 1) contains the declaration for the WinBuffered class. I general¬ 
ly give classes names that let you determine their ancestors at a glance, and I assign 
them a unique “root name" for use by classes that descend from them. For example, 
I use "Twin” as the root name for OWL'S Window class, and as the comment near 
the top of Listing 1 indicates, I've assigned “TWinBuf” as the root name for Win- 
Buffered. 

The WinBuffered class is abstract because its 
prvDraw() is defined as a pure virtual function. Des¬ 
cendants provide their own version of prvDraw() to 
render their image in one or more device contexts. (I 
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describe how this works in more detail in an example class, 
TWinBuf Lines, later.) I've added the "prv" prefix to the func¬ 
tion name to remind myself that it's only for use by this class 
or its descendants; this isn't really important in a program this 
size, though it can be useful in classes that maintain and ex¬ 
plicitly check their internal states after each public function 
call. 

TWinBuffered contains three member variables. The first, 
bBufferedRedraw, is a flag that indicates whether buffered 
redrawing is in effect at any given time. hbmBuffer is a handle 
to the bitmap where the window’s image is buffered —it’s 0 if 
there is none. And after the window receives the first WM_SIZE 
message, the size variable will always contain the dimensions 
of the window’s client area in device coordinates (pixels). 

winbuf.cpp (Listing 2) is where most of the work for buf¬ 
fered redrawing takes place. The TWinBuffered constructor 


Listing 1 winbuf.h — Declaration of buffered 
window class 


fifndef W1NBUF_H 
Idefine _WlNBUFJi 

#ifndef _0Wl_H 

# include <owl.h> 

#endif 

#i fndef _WINDOWSX_H 

# include <windowsx.h> 

#endif 

//.-.-.-. 

// TWinBuffered ("TWinBuf") 

// 

// An abstract window class that tries to allocate 
// a buffer whenever its size changes (unless buffering 
// is turned off). It then processes redraws by 
// BitBlt'ing from its buffer whenever possible. 

// 

class _EXP0RT TWinBuffered : public TWindow 

i 

public: 

TWinBuffered(PTWindowsObject AParent, 

LPSTR ATitle, 

PTModule AModule = NULL, 

BOOL bBufferedRedraw_ = TRUE); 

virtual "TWinBuffered(); 
virtual void SetbBufferedRedraw(BOOL b); 

protected: 

BOOL bBufferedRedraw; // use a redraw buffer or not 
HBITHAP hbmBuffer; // our redraw buffer, if any 

SIZE size; // size of our client area 

virtual LPSTR GetClassName() 

( return “TWinBuffered”; ) 

virtual void WMSize (RTMessage) = [WM_FIRST + WM SIZE]; 
virtual void Paint(HDC hdc, PAINTSTRUCT&); 

// 

// For internal use only: 

// 

virtual void prvDrawWithBuffer(HDC hdc.PAINTSTRUCT &ps); 

// 

// Desendants must provide a version of this. 

// 

virtual void prvDraw(HDC hdc, HDC hdc2 = 0) = 0; 

); 

lendif // fifndef _WINBUF_H 
/* End of File */ 


takes the same arguments as OWL’S TWindow constructor (a 
pointer to a parent window object, a title string, and a pointer 
to an OWL TModule object), plus a flag that indicates whether 
buffered redrawing will be initially enabled or disabled. I give 
arguments that correspond directly to class member variables 
the same name as the corresponding variable followed by an 
underscore, so the last argument’s name is bBuffered- 
Redraw_. 

The constructor simply sets the bBufferedRedraw flag ap¬ 
propriately, then assigns 0 to the hbmBuffer member variable, 
indicating that the window doesn’t have a buffer yet. The 
next function, the destructor, checks to see if the window has 
a buffer, and if so, deletes it. 

Responding to WMJSIZE 

WMSize (), called whenever the window receives a WM_SIZE 
message, is the heart of the buffered redrawing algorithm. The 


Listing 2 winbuf.cpp — Implementation of buffered 
window class 


linclude “winbuf.h" 

// . - . 

// Constructor 
// 

// bBufferedRedraw_ -- initial buffer redraw flag 
// 

TWinBuffered::TWinBuffered(PTWindowsObject AParent, 

LPSTR ATitle, 

PTModule AModule, 

BOOL bBufferedRedraw_) 

:TWindow(AParent, ATitle, AModule), 
bBufferedRedraw(bBufferedRedraw ) 

( 

// 

// Buffer isn't created until WMSize(). 

// 

hbmBuffer = 0; 

) 

//. - . - . - 

// Destructor 
// 

TWinBuffered::~TWinBuffered() 

{ 

if(hbmBuffer) DeleteBitmap(hbmBuffer); 

} 

// . 

// If our buffered redraw flag is set, free our existing 

// bitmap buffer, if any, and try to allocate another 

// one. If we get it, redraw its contents — and at the 

// same time, draw the window contents. Validate the 

// window after the drawing is complete. 

// 

void TWinBuffered::WMSize(RTMessage msg) 

{ 

TWindow::WMSize(msg); 

size.cx = msg.LP.Lo; 
size.cy * msg.LP.Hi; 

if(bBufferedRedraw == FALSE) 
return; 

// 

// If no size, nothing to do. 

// 

if((size.cx — 0) && (size.cy -* 0)) 
return; 
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Listing 2 continued 


II 

II If we have a buffer, delete it. 

// 

if(hbmBuffer) 

DeleteBitmap(hbmBuffer); 

// 

// Try to create a new one. 

// 

HDC hdcScreen = GetDC(O); 

hbmBuffer = CreateCompatibleBitmap(hdcScreen, 

size.cx, size.cy); 

ReleaseDC(0, hdcScreen); 

// 

// If no luck, we’re done. 

// 

if(hbmBuffer == 0) 
return; 

// 

// Clear the contents of the buffer with light gray. 

// 

HOC hdcBuf - CreateCompatibleDC(O); 

HBITMAP hbmSave = SelectBitmap(hdcBuf, hbmBuffer); 

RECT rc; 

rc.left - rc.top = 0; 
rc.right = size.cx; 
rc.bottom ■ size.cy; 

FillRect(hdcBuf, &rc, GetStockBrush(LTGRAY_BRUSH)); 


// 

// Clear the window with light gray, then draw in the 
// window and buffer at the same time. 

// 

HDC hdcWin = GetDC(HWindow); 

FillRect(hdcWin, &rc, GetStockBrush(LTGRAY_BRUSH)); 
prvDrawfhdcBuf, hdcWin); 

// 

// Clean up. 

// 

ReleaseDC(HWindow, hdcWin); 

SelectBitmap(hdcBuf, hbmSave); 

DeleteDC(hdcBuf); 

// 

// Validate entire window so no WM_PAINT. 

// 

ValidateRgn(HWindow, NULL); 


// If we're supposed to do buffered redrawing and we've got 
// a buffer, use the buffered drawing function, else use 
// the regular drawing function. 

// 

void TWinBuffered::Paint(HOC hdc, PAINTSTRUCT &ps) 

{ 

if(bBufferedRedraw && hbmBuffer) 
prvDrawWithBuffer(hdc, ps); 

el se 

prvDraw(hdc, 0); // 0 indicates no second DC 
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first thing it does is call TUindou::UMSize(), which allows 
TUinBuffered's ancestor, TUindow, to perform its UM_SIZE 
processing. Next, it uses the UM_SIZE parameters to update 
the size member variable to reflect the size of the client area. 
Then, if the window's buffer flag isn't set or its size is zero, the 
function simply returns. The window's client area will remain 
invalid and the window will receive a UM_PAINT message later 
on. 

If the window's buffer flag is set, however, the function 
checks to see if the window currently has a handle to a bit¬ 
map buffer, and if so, it deletes it. Next, the function tries to 
allocate a new buffer that’s the same size as the window's 


client area and compatible, in terms of the number of colors 
and how the bits are organized, with the display (as indicated 
by GetDC(O)). If the attempt fails, which could occur if there 
isn't enough memory available for the bitmap, then the func¬ 
tion returns. This won't cause problems, however, since nor¬ 
mal UM_PAINT processing will still update the window's con¬ 
tents. 

Once a buffer is available, the function creates a local 
device context for the bitmap, selects the bitmap into it, and 
clears the bitmap with a light gray brush. A more generalized 
approach would use the window’s background brush for clear¬ 
ing, but I used a stock brush to keep the program short. As an 
aside, unless you're really interested in 
what portions'of memory look like when 
they’re displayed as a bitmap, don’t for¬ 
get to clear the buffer — I forgot the first 
time through, and I saw images that 
resembled a new form of fractal art. 

The next step is to get (as opposed to 
create) a local device context for the 
window and call the pure virtual func¬ 
tion prvDraw() (discussed later). Once 
the image has been drawn, the program 
cleans up by releasing the window’s 
device context, de-selecting the bitmap 
from the local device context, then 
deleting the local device context. Finally, 
since the window's contents have al¬ 
ready been rendered, there’s no need 
for the um_paint message that normally 
follows UM_SIZE messages. A call to 
ValidateRgn() tells Windows that the 
window's contents are up-to-date. 

Painting 

Once the window's buffer is set up 
and its contents are valid, it's ready for 
ordinary UM_PAINT messages. When it 
receives one, OWL'S UMPaintf) calls 
BeginPaintf) to get a handle to a 
device context, calls TUin- 
Buffered::Paint(), and finally calls 
EndPaintf) automatically. If you weren't 
using OWL, you would perform these 
steps manually in your own UM_PAINT 
processing function. 

TUinBuffered:: Paint () is very 
simple. It checks to see if the buffered 
redraw flag is set and if the handle to 
the bitmap buffer is non-zero; if so, it 
calls prvDrawUithBuffer(). If not, it 
simply calls prvDrawf) with the handle 
to the painting device context as the 
first parameter and a zero as the second 
parameter, indicating that there’s only 
one device context to draw in. 

TUinBuffered:tprvDrawUithBuffer 
() is where ordinary buffered redraws 
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Listing 2 continued 

1 

// Clean up. 

//. 

SelectBitmap(hdcLocal, hbmSave); 

// Use BitBltf) to copy all or part of our buffer to the 

DeleteDC(hdcLocal); 

// DC provided. Use the rcPaint member of the PAINTSTRUCT 

i 

// to figure out how much to draw. 


// 

//- 

void TWinBuffered::prvDrawWithBuffer(HDC hdc. 

// Turn buffering on or off. If it's turned on, force a 

PAINTSTRUCT &ps) 

// redraw by sending a dummy WM SIZE message to ourselves. 

( 

// If turned off, force a redraw with InvalidateRectO. 

it 

// 

// Create a DC that's compatible with the one that's 

void TWinBuffered::SetbBufferedRedraw(B00L b) 

// passed in, then select our buffer bitmap into it. 

i 

// 

bBufferedRedraw ■ b; 

HDC hdcLocal = CreateCompatibleDC(hdc); 


HBITMAP hbmSave = SelectBitmap(hdcLocal, hbmBuffer); 

If(b) ( 


RECT rc; 

// 

GetClientRect(HWindow, &rc); 

// Copy the required portion from the buffer to the DC. 

SendMessage(HWindow, 

// 

WM SIZE, 

RECT &rc = ps.rcPaint; 

(WPARAM)O, 

int nWidth * rc.right-rc.left; 

MAKELPARAM(rc.right, rc.bottom)); 

int nHeight * rc.bottom-rc.top; 

} else { 


if(hbmBuffer) ( 

BitBltfhdc, // dest UC 

DeleteBitmap(hbmBuffer); 

rc.left, rc.top, // dest upper left corner 

hbmBuffer = 0; 

nWidth, nHeight, // dest size 

InvalidateRect(HWindow, NULL, TRUE); 

hdcLocal, // source DC 

1 

rc.left, rc.top, // source upper left corner 

) 

SRCC0PY)J 

1 

// 

// End of File 
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are handled. It extracts the location and size of the invalid 
rectangle from its PAINTSTRUCT parameter, then uses Bit- 
Bit () to copy all or part of the bitmap buffer to the window. 
This routine isn’t very exciting, but it is very fast. 

The last routine in winbuf.cpp is TUinBuffered::Setb- 
BufferedRedraw(), which lets you turn buffering on and off 
"on the fly.” If you turn it on, the function forces a redraw by 
sending a dummy UM_SIZE message to the window. The mes¬ 
sage won't change the window's size, but will cause a new 
buffer to be created. If you turn buffering off, any existing 
bitmap buffer is deleted and the entire window is invalidated. 
The invalidation isn't really necessary, but I’ve included it to 
make it obvious when the buffered redraw flag is changed. 

An Example 

That's all there is to the TUinBuffered class. To see how it 
works, it's necessary to look at a class that's derived from it 
(since TUinBuffered is an abstract base class), winlin.h (List¬ 
ing 3) contains the declaration for the TUinBufLines class. 
Note that its class name begins with “TWinBuf,” the root name 
of the TUinBuffered class, so you can determine its ancestors 
immediately, without having to browse the class hierarchy. 
The required prvDraw() function is declared in winlin.h and 
implemented in winlin.cpp. 

The only inline function of interest in winlin.h is U- 
MRButtonDown(), which is called whenever you click the right 
mouse button in a TUinBufLines window. It simply calls 


Listing 3 winlin.h — Header file for winlin.h 


#ifndef _WINLIN_H 
Idefine _WINLIN_H 

#ifndef _WINBUF_H 
# include ''winbuf.h" 

#endif 

//. 

// TWinBufLines ("TWinBufLin") 

// 

// A window to demonstrate the effectiveness of buffered 
// redraws. Click the right mouse button in the window 
// to toggle buffering on and off. 

// 

class _EXPORT TWinBufLines : public TWinBuffered 

( 

public: 

TWi nBufLi nes(PTWindowsObject AParent, 

LPSTR ATitle, 

PTModule AModule = NULL, 

BOOL bBufferedRedraw_ = TRUE) 

:TWinBuffered(AParent, ATitle, AModule, 
bBufferedRedraw) ( ) 

protected: 

virtual LPSTR GetClassName() { return "TWinBuffered”; } 

virtual void WMRButtonDown(RTMessage) 

= [WM_FIRST + WM_RBUTT0ND0WN] 

( SetbBufferedRedraw(ibBufferedRedraw); ) 

virtual void prvDraw(HDC hdc, HDC hdc2 = 0); 

1; 

lendif // #ifndef _W1NLIN_H 
/* End of File */ 


SetbBufferedRedrawf) with the inverse of the current buf¬ 
fered redraw flag, in effect toggling the buffered redraw state 
on and off. A feature like this can be handy if you want to 
experiment with buffered redrawing with a particular type of 
window to see whether it's worth using or not. 

winlin.cpp (Listing 4) contains a single function: TUinBuf¬ 
Lines: :prvDraw(). Its two parameters are hdc and hdc2 
(which has a default value of 0, as indicated in its declaration 
in both winbuf.h and winlin.h). As I mentioned earlier, this 
function’s job is to draw the window's image in one or more 
device contexts at once. These device contexts might cor¬ 
respond to the bitmap buffer or the window on the screen, 
though this routine treats both contexts the same way. 

prvDrawf) is set up so that it will always draw in the first 
device context (represented by hdc), but will draw in the 
second only if its handle (hdc2) is non-zero. The idea is to 
perform all the calculations required to generate the image 
once, then to execute the actual drawing primitives either 
once or twice, depending on whether a second device context 
has been provided. Assuming that the calculations are rela¬ 
tively complex, the overhead of executing drawing primitives 


Listing 4 winlin.cpp — Sample prvDrawQ code 


linclude <math.h> 
linclude "winlin.h" 

// . 

// Draw a basic Moire pattern that fills the window. Use 
// red if we're buffered, blue if not. The algorithm is 
// slow on purpose to emphasize the buffered redraw effect. 
// 

void TWinBufLines::prvDraw(HDC hdc, HDC hdc2) 

( 

HPEN hpen, hpenSave, hpenSave2; 
if(bBufferedRedraw) 

hpen = CreatePen(PS_SOLID, 0, RGB(255,0,0)); 

else 

hpen = CreatePen(PS_SOLID, 0, RGB(0,0,255)); 

hpenSave = SelectPen(hdc, hpen); 
if(hdc2) 

hpenSave2 = SelectPen(hdc2, hpen); 

for(int i=0; i<size.cx; i+=2) ( 
for(int j=0; j<size.cy; j+=2) { 
long x = i - size.cx / 2; 
long y = j - size.cy / 2; 
int d = (int)sqrt(x*x + y*y); 
if(d & 1) ( 

MoveTo(hdc, i, j); 

LineTo(hdc, i+1, j); 
if(hdc2) ( 

MoveTo(hdc2, i, j); 

LineTo(hdc2, i+1, j); 

} 

) 

) 

) 

SelectPen(hdc, hpenSave); 
if(hdc2) 

SelectPen(hdc2, hpenSave2); 

DeletePen(hpen); 

) 

// End of File 
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a second time is fairly small. If the calculations are very 
simple, the window probably shouldn't be buffered anyway. 

TUinBufLines::prvDraw() chooses a red pen for buffered 
drawing and a blue pen for non-buffered drawing. This is just 
to emphasize the difference between the two drawing 
methods; in a real application you would generate exactly the 
same image in either case. The image itself is a basic moire 
pattern whose pixels are on if their distance from the center 
of the window is odd and off otherwise. The algorithm is 
deliberately very primitive, just to simulate a more complex 
calculation. 

app.cpp (Listing 5) contains a very basic OWL T- 
Application descendant, which I've called TApp. All it does is 
create a TUinBuf Lines instance as its main window. The Uin- 
Main() function is also included in app.cpp- it creates an in¬ 
stance of TApp, tells it to run, and then returns its status. 
buf.def (Listing 6) contains a very generic module definition 
file for the demonstration program. 

Flushing the Buffer 

To see buffered redrawing in action, try running the 
sample program. By default, buffering is enabled (which will 
be evident because the lines will be red, not blue). Try cover¬ 
ing all or part of the window, and compare the time it takes 
to redraw the image to the amount of time it took to 
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generate it. Notice that when you resize the window, the 
slower, initial generation is repeated, but future redraws take 
advantage of buffering and as a result are faster. 

Now click the right mouse button inside the window. The 
image will be regenerated, this time in blue. You might note 
that the initial generation is slightly faster than the generation 
with buffering enabled, though not by much. Try covering and 
uncovering the window, just as you did when buffering was 
turned on. This should demonstrate the merits of buffered 
redrawing for images like this one. 

Buffered redrawing certainly shouldn’t be used by every 
program. As mentioned earlier, if drawing the entire image 
from scratch as is as fast or faster than BitBlt() ing all or part 
of it into a window, you're better off without buffering. And if 
you know you’re running on a machine with limited resour¬ 
ces, or if the user doesn’t want your application to dominate 
the memory system, buffering may not be a good idea. But 
under the right circumstances, buffered redrawing can really 
make your programs look and feel more responsive. □ 


Listing 5 app.cpp — Demo program for buffered 
redraw 


linclude "winlin.h" 


//. 

// An OWL application class that creates a TWinBufLines 
// main window with buffered redraw turned on by default. 
// 


class _EXP0RT TApp : public TApplication 
{ 


public: 

TApp(LPSTR AName, HINSTANCE hlnst, HINSTANCE hPrevInst, 
LPSTR lpCmdLine, int nCmdShow) 
:TApplication(AName, hlnst, hPrevInst, 
lpCmdLine, nCmdShow) ( ) 
virtual void InitMainWindow() 

{ MainWindow = new TWinBufLines(NULL, 
"Buffered Redraw Demo"); } 


}; 


// Create a TApp application, tell it to run, and exit. 

II 

int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInst, 
LPSTR lpCmdLine,int nCmdShow) 

{ 

TApp appC'TApp", hlnst, hPrevInst, lpCmdLine, nCmdShow); 

app.Run(); 

return app.Status; 


// End of File 


Listing 6 buf.def - Module definition file for 
buffered redraw demo 


EXETYPE WINDOWS 

CODE PRELOAD MOVEABLE DISCARDABLE 
DATA PRELOAD MOVEABLE MULTIPLE 
HEAPSIZE 4096 
STACKSIZE 5120 
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Windows Installation Utilities 

Victor R. Volkman 


[Editor’s Note: This article reviews installSHIELD vl.3. Stirling 
Technologies informs us that v2.0, which begins shipping 1 
Julg 1993, contains significant enhancements. We are there¬ 
fore including here the updated information provided to us 
bg Stirling.] 

Introduction 

Before Microsoft introduced Windows 3.0 in 1990, most 
Windows applications had a very informal installation process. 
They typically required you to run a DOS batch file to copy 
the files and then manually create an entry in the Program 
Manager. However, consumer expectations have risen consid¬ 
erably since then. The increasing sophistication of install 
programs for Microsoft's own retail products (e.g., Microsoft 
Money) contributes to this trend. 


Product Information 


Setup Toolkit for Windows 
(included with Windows 3.1 SDK) 

Microsoft Corporation 
One Microsoft Wag 
Redmond, WA 98052-6399 


Installation software is critically important: it must succeed 
in order for the end user to run your application. Since users 
must run the install software first, it's also an opportunity to 
make a good first impression. In this discussion, I describe two 
tools that help developers lighten the installation support bur¬ 
den: Setup Toolkit for Windows, by Microsoft, and 
InstallSHIELD, by Stirling Technologies, Inc. Before detailing the 
specifics of both toolkits, however, I want to review some of 
the basic requirements and nomenclature of modern installa¬ 
tion software. 


Product Information 


InstallSHIELD 

Stirling Technologies, Inc. 
172 Old Mill Drive 
Schaumburg, IL 60193 
USA 

Phone: (708)307-9197 
Fax: (708)307-9340 
BBS: (708)307-9939 
CompuServe: GO STIRLING or 
Email: 76702,1607 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a contributing editor for 
Windows/DOS Developer's Journal since 1990. He is currently employed as Senior Analgst at H.C.I.A in Ann Arbor, Michigan. He can 
be reached bg dial-in at the HAL 9000 BBS (313) 663-4173 or bg Usenet mail to sysop0hal9k.ann-arbor.ini .us . 








Why Setup Toolkits? 

For purposes of this discussion, the terms "setup” and “in¬ 
stall” will be synonymous. What does a setup program do 
that necessitates a toolkit? Here’s a short list of tasks con¬ 
sumers expect of an automated setup program (in no par¬ 
ticular order): 

• Check disk space before starting 

• Copy and decompress files 

• Prompt for media changes 

• Prompt for install path 

• Provide help on prompts 

• Query and update . INI files 

• Change autoexec.bat and config.sys 

• Display “% complete" status 

• Create program groups and icons 

• Check for required hardware and software versions 

Setup Toolkits 

Installation toolkits add a post-processing stage to the 
familiar cycle of editing, compiling, and linking. As with any 
other development tool, the installation toolkit itself resides 
on your hard disk and can be invoked via make files or batch 
files. Installation toolkits for Windows must be language 
driven to meet its diverse requirements. Thus, every install 
script is itself an application and ought to be tested and 
debugged under realistic conditions. Most toolkits offer limited 
debugging assistance apart from a preliminary syntax check. 


Your install script handles your complete set of executable, 
data, support, help, and documentation files during installa¬ 
tion. Getting these files onto the distribution disks is an issue 
in itself. If your product consists of less than four megabytes 
of distribution files, you can manually work out the best way 
to fill up the diskettes. However, if you have more than four 
megabytes, more than two media capacities (e.g., 720Kb, 
1.44Mb, 1.2Mb, 360Kb), or frequent deliveries, then a toolkit 
with disk layout tools becomes almost a necessity. A disk 
layout tool, if available, bundles files together into “distribution 
disk images” according to the media capacity you request. The 
disk layout tool also takes file compression into account in its 
calculations. As a final step, you may then format the distribu¬ 
tion disks and copy the disk images onto them. 

The contents of the distribution diskettes depend entirely 
on your application. Nevertheless, distribution diskettes built 
with setup toolkits have some common characteristics. Specifi¬ 
cally, they always contain launchers, installation processors, 
and setup scripts. 

The "launcher" or “bootstrapper" program kickstarts the 
whole installation process. By convention, end users expect its 
name to be A:\SETUP.EXE. The launcher, which normally 
resides on the first diskette of the installation set, has two 
important tasks. First, it copies the “installation processor," 
“setup script," and support files to the hard disk, so that the 
user won't need to re-insert diskette #1 later on during 
execution. Since the user has not yet had an opportunity to 
specify a destination path, the files must be copied to a 



Figure 1 MS Setup opening screen 
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temporary directory name. Second, the launcher invokes the 
installation processor via UinExecf), and then terminates. 

The "installation processor” interprets and executes the 
setup script The installation processor may be a standalone 
executable or it may require accompanying DLLs and support 
files. The installation processor might interpret the script as an 
ASCII file or in a p-code format, depending on implementation. 
The installation processor must be capable of interfacing to 
user-defined DLLs to fulfill custom programming needs. The 
installation processor need not remain on the end user’s hard 
disk after the setup completes. 

The “setup script” tells how to do the actual installation. 
The setup script may examine the hardware configuration, 
query with dialog boxes, and alter .INI files, among other 
things. In any case, the script can call functions in DLLs to 
handle custom installation requirements (for example, you 
might need such a function to detect special adapters or 
TSRs). Last, a common symbol table must allow the script and 
DLL to share data easily. 

Setup Toolkit for Windows 

The Microsoft Windows 3.1 Software Development Kit (SDK) 
now includes the “Setup Toolkit for Windows,” a tool not 
available in earlier versions of the Windows SDK. This toolkit, 
hereafter referred to as MS Setup, consists of a Microsoft Test 
runtime plus sufficient source code, DLLs, and examples to get 
you started. MS Setup also includes an interactive disk layout 
utility and a batch utility to generate distribution disk images. 


Figure 2 MS Setup development cycle 
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In MS Setup, the launcher (SETUP. EXE) copies the installa¬ 
tion processor, support DLLs, include files, setup script file, and 
a file information database into the temporary directory. The 
launcher then spawns the installation processor with the 
setup script filename on the command line. The installation 
processor then immediately begins executing the setup script 
(see Figure 1). 

Microsoft Test serves as the installation processor for MS 
Setup. The runtime (_MSTEST.EXE) interprets TestBASIC from 
plain ASCII .MST files. MS Setup includes a complete library of 
more than 100 script support procedures for handling com¬ 
mon installation requirements. Since the structure and syntax 
of modern BASIC language products are well-known, I’ll focus 
on the symbol table and script support procedures unique to 
MS Test. Figure 2 shows an overview of the MS Setup develop¬ 
ment cycle. 

Symbol Table and DLLs 

As mentioned earlier, the symbol table provides the 
mechanism that allows the script to share variables with DLL 
functions. In MS Setup, all dialog box handlers must reside in a 
DLL. The typical flow of control starts with the BASIC script 
invoking a modal dialog box handler via UIStartDlgO. For 
example, 

sz$ = UIStartDlg(CUIDLL$, 

DESTPATH, "FEditDlgProc", 

APPHELP, HELPPR0C$) 


invokes the DESTPATH dialog box (ID=300) by calling the ex¬ 
ported FEditDlgProc() dialog handler from MSCUISTF.DLL. 
Next, the user enters some values in the dialog edit field (see 
Figure 3). When the user hits OK, the dialog handler retrieves 
the edit value. It then sets the symbol table value EditText- 
Out by calling FSetSymbolValue(). After regaining control, the 
script calls GetSymbolValue() to discover the value of the 
EditTextOut symbol, for example, 

DEST$ = GetSymbol Valuep'EditTextOut") 

The MS Setup documentation covers only how to invoke 
dialog handlers from DLLs. Fortunately, calling standard func¬ 
tions from DLLs is straightforward —you simply insert a for¬ 
ward declaration with the DECLARE statement. For instance, 
the DdePostAdvise () function from the DDE Manager Library 
ddeml.dll is declared as follows in ddeml.h: 

BOOL WINAPI DdePostAdvise( 

DWORD idlnst, HSZ hszTopic, 

HSZ hszltem); 

You would call this function as follows in TestBASIC: 

DECLARE FUNCTION DdePostAdvise 

LIB "ddeml.dll" (Sidlnst as long, 

&hszTopic as long, 

&hszltem as long) as integer 



Figure 3 MS Setup DESTPATH dialog box 
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Setup Disk Layout Utility 


Layout-Time Options 
“ File Destination 
<§> JL Any Diskette 
O 2. Writable Diskette 
O 3. Read-Only Diskette 
O 4. Setup Diskette (#1) 


Source Directory: 
c:\windev\mssetup 


File Attributes' 
CD System File 
□ Shared File 
S Vital File 


Compress 

S Check for Version 


_mstest.exe 

bldcuiNbitmap. dib 

bldcuAbldverh 

bldcuAcui.h 

bldcuiVcuistf.Ink 

bldcui\cuistfd.lnk 

bldcui\dialogs. dig 


bldcuiSdialogs.rc 
bldcuAdialogs. res 
bldcui\dlgprocs. c 
bldcuAmakefile 
bldcuiAmscomstf. lib 


Install-Time Options 
“Overwrite 

® Always 
O Never 

O Older 
O Unprotected 


E3 Decompress 

£3 Mark as Read Only 
f~l Rename Copied File: 

[X] Backup Existing File: 


hldcuflmscuisU.def 


dialogs, bak 


CH Just Show New 


bldcuftdialogs.h 


O 5. Do Not Lay Out File 

® Source Date O Other: 



Reference Key: 


Put in Section: 




Figure 4 MS Setup dsklayt tool 
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communications protocols. 
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Setup toolkits at a glance 

Item 

MS Setup 

InstallShieid 

Media Overhead Min. 

380Kb 

230Kb 

Media Overhead Max. 

420Kb 

254Kb 

Script language 

TestBASIC 

C-Like 

Script interpreter 

plain text 

p-code 

Custom DLL handling 

Call any DLL via 
passthru 

Call only via 
special 
mechanism 
[v2.0 —call only 

DLL] 


All of the examples for MS Setup actually employ a "wrapper” 
function to display a dialog box with error messages in case of 
failure. For more advanced usage, you'll probably want to buy 
the full Microsoft Test product 

Script Support Procedures 

The script support procedures add the specialized tools 
that make setup applications possible. Broadly, these proce¬ 
dures support the CopyList, billboards, file and directory han¬ 
dling, , INI updates, icons and groups, registration database, 
system resources, MS-DOS 5.0 help, logging, and environment 
queries. 


Source Code Availability 

Bulletin Board S] 

/stems 

Phoenix Chapter 
ACM Library 

(602) 970-0474 

The 

Programmer’s 

Corner 

(301) 596-7692 or (410) 995-6873 

The Courts of Chaos 

(501) 985-0059 

EmmaSoft 
Shareware Board 

(607) 533-7072 

Cornerstone 

(206) 362-4283 

Other Systems 

CompuServe 

GO CLMFORUM, section 7 

BIX/WIX 

join listings, change areas to 
“win.dos.dev” 

GEnie 

In the Windows Roundtable at page 

1335 (Keyword:Windows). 

uunet 

~/published/windowsdos/19YY/monYY.zip 
Accessible via anonymous FTP from 
ftp.uu.net or via uucp from 
(900) GOT-SRCS (login name “uccp”, no 
password, $.50 per minute). 


The CopyList metaphor in MS Setup allows your setup 
script to gradually build an installation laundry list. Several 
script support procedures make manipulating the CopyList as 
easy as possible. For example, you can provide a dialog box 
with a set of checkboxes for picking optionally installable files. 
The user could then select whether or not to install help files, 
tutorials, example files, etc. If the user asks for help files, a 
single call to AddSectionFilesToCopyList() can concatenate 
a group of them. Eventually, your setup script calls Copy- 
FilesInCopyList() to actually begin copying files from dis¬ 
kettes. 

MS Setup scripts can invoke special messages to appear on 
"billboards” during the installation. A billboard is a modeless 
dialog box displayed during the CopyFilesInCopyList() pro¬ 
cedure. Normally, these dialogs contain only text and not con¬ 
trols. You can queue up an entire set of billboards by calling 
AddToBilIBoardListf) once for each message. A typical 
billboard message might be: "Now is a good time to fill in your 
registration card!” You can schedule the removal of the pre¬ 
vious billboard by calling AddBlankToBillBoardList(). 

The file and directory handling functions perform special 
operations beyond the basics that CopyFilesInCopyList() 
provides. Specifically, you can backup, copy, remove, or 
rename any file in a single step. In addition, you can search 
for a file by several different methods: simple existence, tree 
search, and environment variable (e.g., PATH). Once the file is 
located, you can return its date or size and even burn-in 
resource strings. 

Setup programs should transparently modify any . INI files 
necessary to complete the installation. MS Setup allows you to 
create keys, test for their presence, and remove existing keys. 
At the section level, you can test for the presence of a . INI 
section with DoesIniSectionExist() or drop an entire sec¬ 
tion with RemovelniSectionf). Of course, you can also read 
existing keys in .INI files and parse comma-delimited argu¬ 
ments. For instance, to read the baud rate of COM1 serial port: 


Com$ = Get IniKeyString("WIN.INI", "ports", "C0M1:") 
Baud$ = GetNthFieldFromIm'String(Com$, 1) 


Interacting with Windows Program Manager files is an equally 
important setup requirement. First, a setup program normally 
calls CreateProgmanGroup () in case the desired group does 
not yet exist. Next, you can optionally call ShowProgman- 
GroupO so that an alert user can watch the icons appear. 
Last, CreateProgmanltemO puts the application icon in the 
group and redraws the corresponding group window. Create- 
ProgmanItem() even allows you to pick the (X,Y) coordinates 
for the icon in the group. 

MS Setup provides additional wrapper functions to access 
the Registration Database. The Registration Database stores 
the associations that both the File Manager and Object Linking 
and Embedding (OLE) applications require. The script support 
procedures simply pass the parameters through to the cor¬ 
responding SHELL.DLL call. The naming convention differs 
slightly - for example, you must call SetRegKeyValue() 
rather than the original RegSetValue(). (See Chapter 7 of the 
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Microsoft Windows Programmer’s Reference: Vol. I for complete 
details on the Registration Database.) 

The MS Setup toolkit also tackles the tough problem of 
installing system resource files. MS Setup defines “system” (or 
"shared”) “resource files” as any files potentially open and in 
use when your setup script is running. For instance, your dis¬ 
tribution may require a newer replacement device driver, 
TrueType font, or a DLL. Since Windows lets you run more 
than one application at a time, the possibility exists that at 
least one of these system files is already in use. Simply over¬ 
writing a system file willy-nilly might easily hang the next ap¬ 
plication to call it. 

Fortunately, MS Setup provides script support functions to 
handle system resource files. To find a file, your script must 
call SearchForLocationForSharedFile(). This procedure fol¬ 
lows keys in the Registration Database and MIN. INI in its 
search. If it finds the file, it sets the global variable Share- 
FiledNeedsCopying to TRUE. Accordingly, your script must 
then call AddSpecialFileToCopyList(). Each call further 
builds up a batch file called MSSETUP.BAT. When your script is 
ready to terminate, you call ExitExecRestartf) to kick off 
the processing. ExitExecRestartf) exits windows, executes 
_MSSETUP.EXE to run MSSETUP.BAT, and then restarts Win¬ 
dows —all in one step. 

Maintaining a setup log file helps resolve problems during 
development and during final customer installation. The MS 
Setup toolkit provides three simple calls to make a permanent 
record of what happened: OpenLogFilef), MriteToLogFilef), 


and CloseLogFi le(). Additional logging information you might 
want to use is strictly optional. 

Last, MS Setup provides almost three dozen script support 
procedures for querying the system environment. The queries 
gather information from CONFIG.SYS, the underlying hardware, 
and Windows. From CONFIG.SYS, you can read the 
LASTDRIVE=, BUFFERS=, and FILES = values and even the 
parameters for RAMDRIVE.SYS and SMARTDRV.SYS. Hardware 
queries report on drives' free space and return lists of local 
hard drives, network drives, and removable drives. On the 
lowest level, information about serial ports, parallel ports, CPU 
type, screen size, screen type (color or monochrome), 80x87, 
and mouse is readily available. 

The system environment queries also return important in¬ 
formation about Windows. For example, you can discover how 
many Windows applications are currently running by calling 
GetNumWinApps (). Other global Windows attributes such as 
version number, mode, system directory, and shared status 
are equally accessible. You can even read the typeface names 
from TrueType files by calling GetTypeFaceFromName(). 

Disk Layout Tools 

MS Setup also includes an interactive disk layout utility 
(Dsklayt) and a batch utility to generate distribution disk im¬ 
ages ( Dsklayt2). The Dsklayt application reads your distribu¬ 
tion directory and stores setup attribute information in a 
layout (.LYT) file. Dsklayt displays all of its layout information 
in a single window (see Figure 4). A monolithic list box 
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presents the directory listing, from which you can select one 
or more files. The remaining controls operate against the cur¬ 
rently selected file list. The controls pick both layout-time and 
install-time options. 

The layout-time options directly control what the batch 
disk generation utility ( Dsklayt2) does with the each file. 
Specifically, these options control file destination, attributes, 
file date, compression, version checking, reference key, and 
section. 

The file destination options specify which diskette a file 
can appear on: any disk, write disk, read-only disk, first disk, 
or no disk. Note that all setup support files must appear on 
the first disk. File attributes identify special cases for installa¬ 
tion: MS Windows system files, shared DLLs, and vital (abort if 
unable to copy). File date control either leaves the original 
date intact or replaces it with a predefined “release date." If 
you choose compression, then Dsklayt2 handles the file with 
the supplied COMPRESS.EXE utility. If enabled, version checking 
simply looks for a version resource and warns if it is missing. 

The reference key and section layout-time options add 
supplementary information for the setup script. Reference 


keys can pick a single optional file from several possibilities 
and append it to the Copy List in one step. For example, you 
might want to choose a different help file if the user has a 
monochrome monitor. Similarly, you can append an entire set 
of optional files by assigning them a common section. 

The install-time options affect how files will be copied from 
the diskettes during setup. These options handle various over¬ 
write situations during copying: you can specify overwrite to 
occur always, never, only on older files, or only on un¬ 
protected files. Further, you can rename or backup existing 
files if necessary. 

You need run the interactive disk layout utility only when 
you add or subtract filenames from your release. Fiowever, 
you must run the batch disk generation utility (Dsklayt2) 
whenever you want to make an install set. Dsklayt2 requires 
the layout filename (. LYT) that you created with the interac¬ 
tive disk layout utility and the destination directory name. Op¬ 
tional parameters specify such things as the target media size 
and alternate compression utility. 

The end result of this process is a set of subdirectories, one 
per diskette. Given a blank diskette, you may then simply 
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COPY *.* from the appropriate subdirectory. Dsklayt2 at¬ 
tempts to “level" the files across the set of diskettes. For in¬ 
stance, if you had 1800Kb of files destined for 720Kb media, 
then it would attempt to put approximately 600Kb of files on 
each of three diskettes. This maximizes your chances for suc¬ 
cess, because it generally leaves some room to work around 
media defects reported by FORMAT.COM. 

The layout tool has just a few limita¬ 
tions worth mentioning. First, the 
limited size of the list box can make 
long subdirectory paths difficult to view 
in Dsklayt. Second, you cannot specify 
two different files with the same name 
as targets, even if the files are to be 
placed on separate diskettes (as, for ex¬ 
ample, if you wanted the user to be able 
to choose between a network and non¬ 
network version of your program and 
wanted to call that file APP.EXE, regard¬ 
less of which one they actually chose). 

InstallSHIELD 

InstallSHIELD, by Stirling Technologies, 

Inc. (Schaumburg, IL), is another script- 
based setup toolkit. The Stirling Group 
offers InstallSHIELD for both MS Win¬ 
dows ($395) and IBM OS/2 ($595) en¬ 
vironments. Figure 5 shows the opening 
screen of InstallSHIELD for MS Windows. 


The InstallSHIELD installation processor uses a proprietary lan¬ 
guage whose syntax closely matches C. InstallSHIELD includes 
a complete library of more than 100 script support procedures 
for handling common installation requirements. And although 
InstallSHIELD does not have a formal disk layout utility, it does 
have unique capabilities of its own (see Figure 6). 


Figure 6 Setup toolkit advanced feature comparison (ASCII) 
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InstallSHIELD uses a C-tike interpreted script language that 
even has limited implementations of idefine, Hnclude, 
iifdef, and Hifndef preprocessor directives. InstallSHIELD 
scripts can use integer or string variables. The integer variables 
can participate in expressions with +, *, and / operators. 

Bitwise AND, NOT, and OR are also available. The script language 
supports control flow with if-then/else, for/endfor, 
while/endwhile, repeat/until, call/return, goto label, and mode¬ 
less button handlers. 

InstallSHIELD integrates easily with your existing develop¬ 
ment cycle (see Figure 7). The primary difference is the extra 
step of compiling the setup scripts into p-code. The IN- 
STRC.EXE compiler reads in plain text .RUL files and writes out 
binary . INS files. The InstallSHIELD runtime interprets these bi¬ 
nary p-code files during actual installation. If you want to take 
advantage of compression or splitting large files, then you 
must manually add calls to COMPRESS.EXE or SPLIT.EXE in 
your existing make files. 

Symbol Table and DLLs 

Again, the symbol table provides the mechanism for the 
script to share variables with DLL functions. As with most 
script-based products, custom dialog box handlers for 
InstallSHIELD scripts must reside in a DLL [in v2.0 custom dialog 
box handlers can be implemented 9in the script itself]. To in¬ 
voke a DLL function, simply insert a call to ExecuteDLL() in 
the script The following code, for instance, executes the ex¬ 
ported function start() from genabt.dll: 

ExecuteDLL("genabt.dl1".“start"); 


In v2.0, scripts can invoke any DLL function directly. In version 
1.x, the DLL function must match the following prototype 
(shown with the start () function): 

long PASCAL FAR start(hWnd HWND, 

PS_EXP_OBJECT pStrings, 

PI_EXP_OBJECT plntegers); 

The first parameter must be the window handle of the main 
window. The last two parameters point to the global string 
and integer structures respectively. The PS_EXP_OBJECT and 
PIJXPJBJECT are actually variable-length structures. The first 
member ( usCount) of either structure tells how many objects 
the structure contains. The remaining array of SVAR_OBJECTs 
or IVAR_OBJECTs stores pairs of values and IDs. 

Your script can set the value and ID pairs by calling 
ExportStr() or ExportNumf) as needed. For example, sup¬ 
pose you wanted to export the string C:\UIND0US (as ID=4) 
and the amount of disk space free (as ID=23): 

ExportStr("C:\WIND0WS",4); 

ExportNum(nDiskFree,23); 

When you need to get or set one of these values inside the 
DLL function, you must first perform a linear search (see Figure 
8). Any changes you made to the exported values will auto¬ 
matically be available to the script after returning. 

If you need to call a DLL function using the standard Win¬ 
dows interface, such as the DdePostAdvise() in ddeml.dll, 
then you must write a wrapper function accepting the 
proprietary InstallSHIELD calling conven¬ 
tion [in v2.0 you can call a DLL function 
directly from InstallSHIELD], 

Script Support Procedures 

As before, the script support proce¬ 
dures make the difference between a 
general purpose programming tool and 
a toolkit optimized for setup applica¬ 
tions. Broadly, these procedures support 
the symbol table, screen objects, sys¬ 
tem resources, file and directory han¬ 
dling, .INI updates, dialog boxes, 
strings, icons and groups, application 
control, and autoexec/config handling. 
I'll take a brief look at each of these 
functional groups and how they solve 
common setup problems. 

The InstallSHIELD screen object pro¬ 
cedures control things such as bitmaps, 
window attributes, and modeless but¬ 
tons. For instance, you can display or 
remove a bitmap from the screen by 
calling PlaceBitmapO. Bitmaps can be 
loaded directly from .BMP files or as a 
resource in a .DLL file. Bitmaps can 
either appear immediately or slowly 
fade-in as desired. 


Figure 7 InstallSHIELD development cycle 
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The window-related procedures allow you to change the 
size, position, color, and title of any window. The multipurpose 
Enablef) function controls the attributes of the “% complete” 
status bar window. This window can display just percentages, 
percentages and filenames, or can be removed. The Informa¬ 
tion Gauge, a special purpose window, provides three addi¬ 
tional percentage bar displays: completion amount on current 
file copying, RAM available, and hard disk space. You can tog¬ 
gle each of these Information Gauge components (see Figure 

9) . 

InstallSHIELD provides three modeless buttons that display 
throughout the install process: Help, Pause, and Exit (see Figure 

10) . You can show them with the aforementioned Enablef) or 
hide them with Disablef). You can also establish script-based 
callbacks for each button by calling Handlerf). Each handler 
acts as a sort of interrupt-triggered procedure. 

You can access a wide range of system parameters with 
the InstallSHIELD system query procedures. For example, in¬ 
dividual functions report disk space, free memory, mode, dis¬ 
play size, and environment variable contents. You can also 
directly set or get the file date, time, and size information. The 
general-purpose function GetSystemlnfof) reports on total 
disk space, CPU, video, network, language, serial and parallel 
ports, CD-ROM, DOS version, or BIOS version. 

The InstallSHIELD file and directory functions compare 
favorably to those of most high-level languages. You can copy, 
rename, delete, find, split, compress, or merge a file with a 
single call. The split and merge capabilities are critical to han¬ 
dling compressed data files that are still too large to Fit on a 
single diskette. You can create and remove directories with a 
single call as well. 

In addition, the file functions let you read and write the 
contents of an individual file. The SeekBytesf), ReadBytesf), 
and UriteBytesf) functions support the traditional block I/O 
methods. Similarly, Get Line () and UriteLinef) support a 
stream-oriented approach. For .INI files, you can read or 
write a single key at a time. 

InstallSHIELD provides both canned and general-purpose 
dialog boxes for user interaction. The AskPathf) and Enter- 
Disk () functions invoke dialog boxes for entering a path 
name and changing diskettes, respectively. The general pur¬ 
pose functions AskTextf), AskOptionsf ), AskYesNof), and 
MessageBoxf) all display prompts which you specify. The ver¬ 
satile AskOptionsf) function presents a user-defined group of 
checkboxes or radio buttons. If none of these adequately ser¬ 
ves, then you can implement your own custom dialog in a DLL 
[in v2.0 you can implement the dialog in the InstallSHIELD 
script language]. 

The InstallSHIELD string support procedures are comparable 
to those available in C. You can copy, concatenate, compare, 
search, and extract substrings with them. Other standard 
operations include converting between data types, measuring 
string length, and raw byte copying. 

The program group and icon functions talk through the DDE 
interface directly to the Program Manager (usually prog- 
man. exe). This allows your script to create a new group, add 
an icon to a group, delete a group, bring a window group to 
the foreground, and retrieve the list of group names. Adding 
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icons and groups can be transparent to the user if you first 
minimize the Program Manager window, as follows: 

AppCommand(PROGMAN,CMDMINMIZE); 

Although AppCommand() only supports Program Manager, the 
application control functions allow similar control over 
programs. First, you must use FindUindowf) to retrieve the 
window handle corresponding to the application. When you 
have the handle, you may submit messages directly with 


Figure 8 InstallSHIELD searching for an exported 
integer 


Idefine NDISKFREE 23 /* ID value from ExportNumO */ 

bFoundVar = FALSE; 

for (1=0; i < pIntegers->usCount; 1++) 

if (pIntegers->VarExports[i] .iCode *■ NDISKFREE) 

{ 

bFoundVar = TRUE; 

plVal » &pIntegers->VarExports[i].lvalue; 

/* Now I can assign values to *plVal and it 
will be reflected in the script variable 
nDiskFree after we return! */ 
break; 

} 
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SendMessage(). In this case, the support procedure name ex¬ 
actly matches the Windows API function. 

AUTOEXEC and CONFIG Editing 

InstallSHIELD excels in its editing support for the 
AUTOEXEC.BAT and CONFIG.SYS files. Your install script can edit 
these files in the easy (“Ez”) or advanced function groups. The 
easy functions automatically find the right AUTOEXEC.BAT and 
CONFIG.SYS files for you. Moreover, each easy call acts as an 
atomic operation: it opens the file, makes the change, and 
then closes the file. For instance, the EzBatchAddStringO 
function adds a single line to AUTOEXEC.BAT. This line may be 
before or after any other specified line. The following example 
invokes RUNME.BAT immediately after the PATH statement: 



EzBatchAddString("CALL RUNME.BAT", "PATH", AFTER); 

In a similar fashion, you may edit PATH-based environment 
variables (e.g., PATH, LIB, INCLUDE) with EzBatchAddPath(). 
This time, the BEFORE and AFTER keywords refer to substr¬ 
ings in the path. For example, suppose the LIB environment 
variable contains C:\XLIB;C:\WINDEV\LIB and your applica¬ 
tion absolutely requires installation ahead of UINDEV. Assume 
further that your libraries reside in C: \MYLIB. The code in this 
case would look like: 

EzBatchAddPath("LIB","C:\\MYLIB", "WINDEV", BEFORE); 

The easy CONFIG.SYS functions follow the same style as the 
AUTOEXEC.BAT functions. The Ez- 
ConfigAddStringO and EzAddDriverf) 
functions both allow the relative insert 
positions, too. EzConfigGetZalue() and 
EzConfigSetValue() enable easy 
Changes to the FILES=, BUFFERS =, DOS-, 
and other assignments. 

The advanced AUTOEXEC.BAT and 
CONFIG.SYS editing procedures provide 
even more control over these critical 
resources. The advanced functions per¬ 
mit you to both move and delete lines. 



Figure 9 Instal/SHIELD information gauge 


Figure 10 InstallSHIELD 
modeless buttons 
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The following code moves the PROMPT statement to line 1 and 
the PATH statement to line 2: 

BatchMove(“PROMPT"BEFORE); 

BatchMove("PATH","PROMPT",AFTER); 

Deleting lines is even easier with the keyword matching algo¬ 
rithm. Suppose you know that FASTOPEN is incompatible with 
your application and must never be loaded: 

BatchDelete("FASTOPEN"); 

deletes the first occurrence where FASTOPEN is invoked. 

Conclusion 

From the biggest vertical application to the smallest 
shareware package, the Windows user today expects to see a 
sophisticated setup program. Even if your package requires 
nothing more than a destination path, a setup program helps 
smooth out end-user installation problems. Although the two 
products described in this article have some differences (see 
Figure 6), I believe they have far more in common. If you have 
yet to select an installation strategy, I highly recommend con¬ 
sidering a complete toolkit solution such as MS Setup or 
InstallSHIELD. 
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Q l am fairly new at writing Windows programs. I have studied several examples 
and have read several books and magazines, but I’m stuck on a solution to my 
problem. I am writing an MDI edit application (similar to Notepad) that interfaces 
with a database. It works pretty well, or so I thought. I have learned the hard way 
that the "edit” class will locally allocate memory that is limited to the user's data 
segment. This is where my problem begins. How do I create a swap mechanism that 
will allow my application to accept files larger than 32Kb (actually 64Kb)? I would like 
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and W4W. (It would have been nice if Windows had an EM_SETHANDLE for globally 
allocated memory). I am using Borland C++, programming in C. 

Patrick M. McCrocklin 
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A There is no easy way to force an edit control to handle more than 64Kb of text, 
but you can get around the fairly severe default text-size limitations that the 
edit control imposes. By default, an edit control allocates the memory to hold its 
text from the default data segment. The memory available there is likely to be 
much less than 64Kb, since many other pieces of code (such as other edit controls) 
will be competing for space in that same data segment. If you could make an edit 
control use global memory, then it could handle almost 64Kb of text. 

Fortunately, Windows does provide the functionality you require. Though not 
documented in the SDK, it has been publicly discussed by Microsoft representatives, 
so you can consider it a “legal” approach. In fact, if you look at the definition for the 
DS_LOCALEDIT style, this functionality is hinted at. According to the SDK’s on-line 
help, “DS_LOCALEDIT . . . Specifies that edit controls in the dialog box will use 
memory in the application's data segment. By default, all edit controls in dialog 
boxes use memory outside the application's data segment." When the documenta¬ 
tion refers to memory “outside the application's data segment,” it must mean global 
memory (there are other kinds of memory, but these are not generally available to 
a Windows application), so the Windows dialog manager apparently knows how 
make edit controls use global memory. 
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Listing 1 edi tmdi. c - Global memory for edit controls demonstration 

/* editmdi.c */ 

return msg.wParam; 

/* - Demo uses global memory for each MDI edit. */ 

) 

/* - Compile with "cc editmdi.c" */ 


#include <windows.h> 

LRESULT CALLBACK export FrameWndProc(HWND hwnd, 

UINT wm, WPARAM wParam, LPARAM IParam) 

linclude <windowsx.h> 

( 

linclude "editmdi.h" 

CLIENTCREATESTRUCT CCS; 

HWND hwndClient; /* MDI client. */ 

switch (wm) 

/ 

/* Class names. */ 

default: 

char szFramef] = "EditMdiFrame"; /* Frame. */ 

break; 

char szChild[] = “EditMdiChild"; /* MDI kid. */ 


char szAppG = “EditMdi”; /* App name. */ 

case WM CREATE: 

Idefine cbMinEdit 1024 /* Initial edit memory. */ 

/* Window menu to list children. */ 
ccs.hWindowMenu = GetSubMenu(GetMenu(hwnd), 1); 

#define didEdit 1 /* Edit control ID. */ 

ccs.idFirstChild = 0x1000; 

LRESULT CALLBACK export 

/* Create the MDI client. */ 

ChildWndProc(HWND, UINT, WPARAM, LPARAM); 

return (hwndClient = CreateWindow("mdiclient", 

LRESULT CALLBACK export 

NULL, WS CHILD | WS VISIBLE, 0, 0, 0, 0, 

FrameWndProc(HWND, UINT, WPARAM, LPARAM); 

hwnd, 0, GetWindowInstance(hwnd), 

void NewMdiChild(void) ; 

(LPSTR)Accs) ) == NULL ? -1 : 0; 

void TestSetHandle(LPSTR); 


int PASCAL WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

case WM_COMMAND: 
switch (wParam) 

LPSTR lszCmdLine, int wCmdShow) 

( 

{ 

default: 

MSG msg; 

break; 

HWND hwnd; 


if (hinsPrev == NULL) 

case idmNew: 

NewMdiChild(); 

( 

return 0; 

WNDCLASS wcs; 


/* Register the frame class. *7 

case idmTest: 

TestSetHandle("This is a test"); 

wcs.style = 0; 

return 0; 

wcs.1pfnWndProc = FrameWndProc; 

) 

wcs.cbClsExtra = 0; 

break; 

wcs.cbWndExtra = 0; 


wcs.hlnstance = hinsThis; 

case WM CLOSE: 

wcs.hlcon = LoadIcon(NULL, IDI APPLICATION); 

DestroyWindow(hwnd); 

wcs.hCursor = LoadCursor(NULL, IDC ARROW); 

return 0; 

wcs.hbrBackground = 


(HBRUSH)(COLOR APPWORKSPACE + 1); 

case WM DESTROY: 

wcs.lpszMenuName = MAKEINTRESOURCE(idmMDI); 

PostQuitMessage(O); 

wcs.lpszClassName = szFrame; 

return 0; 

if (!RegisterClass(&wcs)) 

) 

return FALSE; 


/* Register the MDI child class. */ 

return DefFrameProc(hwnd, hwndClient, wm, wParam, 

1Param); 

wcs.1pfnWndProc = ChildWndProc; 


wcs.hlcon = LoadIcon(NULL, IDI APPLICATION); 


wcs.lpszMenuName = NULL; 

LRESULT CALLBACK export Chi 1 dWndProc(HWND hwnd. 

wcs.cbWndExtra = 0; 

UINT wm, WPARAM wParam, LPARAM IParam) 

wcs.lpszClassName = szChild; 

i 

if (!RegisterClass(&wcs)) 

switch (wm) 

return FALSE; 

{ 

) 

default: 


break; 

/* Create the frame. */ 


if (! ( hwnd = CreateWindow(szFrame, "MDI", 

case WM CREATE: 

WS OVERLAPPEDWINDOW, 

( 

CW USEDEFAULT, 0, CW USEDEFAULT, 0, 

HGLOBAL hgbl ; 

NULL, NULL, hinsThis, NULL))) 

HWND hwndEdit; 

return FALSE; 


ShowWindow(hwnd, wCmdShow); /* Show frame. */ 

/* Allocate a global block for the edit */ 

/* control. */ 

while (GetMessage(&msg, NULL, 0, .0)) 

if ((hgbl = G1obalA11oc(GHND, cbMinEdit)) == 

if (ITranslateMDISysAccel(hwndClient, &msg)) 

NULL || 

( 

(hwndEdit = CreateWindow("edit", NULL, 

TranslateMessage(taisg) ; 

WS CHILD I WS VISIBLE | WS VSCROLL | 

DispatchMessage(&msg); 

ES MULTILINE, 0, 0, 0, 0, hwnd. 

) 

(HMENU)didEdit, hgbl, NULL)) == NULL) 


return -1; 
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Listing 1 continued 


/* Remove the text length limit. */ 
SendMessage(hwndEdit, EM_LIMITTEXT, 0, 0); 

) 

break; 

case WM_SIZE: 

/* Fill the child's client area with the */ 

/* edit control window. */ 
SetWindowPos(GetDlgItem(hwnd, didEdit), NULL, 

0, 0, LOWORO(lParam), HIW0RD(1Param), 
SWP_NOACTIVATE | SWP_NOMOVE | SWP_NOZORDER); 
break; 

} 

return DefMDIChildProc(hwnd, wm, wParam, IParam); 

} 

void NewMdiChild(void) 

{ 

MDICREATESTRUCT mcs; 

HWND hwnd; 

mcs.szTitle = “Edit Me"; 
mcs.szClass » szChild; 

mcs.hOwner = GetWindowInstance(hwndClient); 
mcs.x = mcs.y = mcs.cx = mcs.cy = CW_USEDEFAULT; 
mcs.style = 0; 

/* Tell MDI to create the child. */ 
if ((hwnd = (HWND)SendMessage(hwndClient, 

WM_MDICREATE, 0, 

(LONG)(LPMDICREATESTRUCT)&mcs)) != NULL) 
ShowWindow(hwnd, SW_SHOW); 

} 

void TestSetHandle(LPSTR lsz) 

y*****************************************************^ 
/* - Test use of EM_SETHANDLE for global memory */ 
/* edit control. */ 

I *****************************************************j 
{ 

HWND hwnd; 

WORD wDS; 

HLOCAL hi cl; 

PSTR pch; 

/* Get the edit control handle in the active MDI */ 
/* child. */ 

if ((hwnd = (HWND)SendMessage(hwndClient, 
WM_MDIGETACTIVE, 0, 0)) == NULL) 
return; 

hwnd = GetDlgItem(hwnd, didEdit); 

/* Get the current buffer and free it. */ 
hi cl = 

(HLOCAL)SendMessage(hwnd, EM_GETHANDLE, 0, 0); 
wDS = (WORD)GetWindowInstance(hwnd); 

_asm push ds; /* Save DS to restore later. */ 

_asm mov ds, wDS; 

/* LocalFree() uses DS to identify heap. */ 

Local Free(hi cl); 

/* Allocate a new buffer, fill with string, and */ 

/* give it to the edit control. */ 

hlcl = LocalAlloc(LHND, Istrlen(lsz) + 1); 

pch = Local Lock(hi cl); 

lstrcpy(MAKELP(pch, wDS), lsz); 

LocalUnlock(hlcl); 

_asm pop ds; 

SendMessage(hwnd, EM_SETHANDLE, (WPARAM)hi cl, 0); 

} 

/* End of File */ 


Making an edit control use global memory is straightfor¬ 
ward: when you create the edit control, use the hInstance 
parameter to pass the handle to a global memory block 
rather than your application’s instance handle. You must ini¬ 
tialize the block to zeros (GlobalAlloc() will do this if you 
specify the GMEM_ZEROINIT flag when you allocate the 
memory). You can allocate as big a block as you like, but the 
edit control will only use the first 64Kb. This is because it 
creates a local heap inside the block that is only 16 bits wide. 
The practical limit will be somewhat smaller than 64Kb since 
the edit control keeps a character-width table (255 bytes) in 
the heap in addition to other bits (no pun intended) of over¬ 
head. I found from experimentation that I could store a little 
over 61,000 characters in a multi-line edit control as a single 
stream of text (no white space). If the edit control does not 
have the multi-line style, the limit is 32Kb. In addition, the edit 
control imposes an initial limit of 32,000 characters, but you 
can override this by sending the edit control an EM_LIMITTEXT 
message with a wParam of 0 to specify a maximum of 64Kb. 

You need to be careful if you intend to use EM_SETHANDLE 
for an edit control using global memory. Again according to 
on-line help, “An application can send this message to a multi- 
line edit control in a dialog box only if it has created the 
dialog box with the DS_LOCALEDIT style flag set.” In other 
words, the documentation is saying you should not send this 
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message to an edit control that is using global memory. The 
reason is that the local handle will (presumably) be from the 
application’s local heap, not from the local heap created in the 
edit control's global block. But if you ensure that the handle 
supplied with the message belongs to the local heap in the 
edit control’s global block, the message will work correctly. 

editmdi.c (Listing 1) contains the main source code for a 
demonstration MDI application (shown in Figure 1) that creates 
a multi-line edit control for each MDI child, editmdi.rc (Listing 
2) contains the menu definitions and editmdi.h (Listing 3) 
contains the menu IDs. This example does not work with Zor- 
tech C++, since that compiler does not support inline assembly 
(except in the form of byte constants). The application also 
demonstrates safe use of the EM_SETHANDLE message. There 
are two menu items in the menu bar, File and Window. The 
File popup menu consists of the menu items New and Test. 


Listing 2 editmdi .rc — Menu definitions for 
editmdi.c 


#iinclude <windows.h> 
linclude "editmdi.h" 

/* Frame window menu. */ 

idmMDI MENU LOADONCALL MOVEABLE DISCARDABLE 
BEGIN 

POPUP "&File" 


BEGIN 

MENUITEM 

"&New\ 

idmNew 

MENUITEM 

END 

"STest", 

idmTest 

POPUP "&Window" 



BEGIN 

MENUITEM 

END 

"&Dummy\ 

1dmDummy 


END 


Listing 3 editmdi.h 

— Menu IDs for editmdi.c 

#define idmMDI 

1000 

/* Main menu id. */ 

Idefine idmNew 

1001 

/* File/New menuitem ID. */ 

Idefine idmTest 

1002 

/* Test edit's capacity. */ 

Idefine idmDummy 

1003 

/* Dummy menuitem. */ 

/* End of File */ 





Figure 1 Demonstrating global memory for edit 
controls 


New creates a new MDI child, and Test uses the EM_SETHANDLE 
message to replace the edit control's buffer with one contain¬ 
ing the string “This is a test.” The Window popup menu is 
maintained by the MDI manager. 

The interesting code begins in the MDI child window proce¬ 
dure, ChildUndProcf). When it receives a WM_CREATE mes¬ 
sage, ChildUndProc () allocates a small chunk of global 
memory and passes the handle to CreateUindow() to create 
a multi-line edit control. ChildWndProc() creates the edit con¬ 
trol with zero width and height, since code in the WM_SIZE 
case ensures that the edit control occupies the MDI child’s 
entire client area. The local heap manager will attempt to 
grow the global block (to a maximum of 64Kb) if it cannot 
fulfill a request for local memory. Starting with a small global 
block saves space that would be wasted if the edit control 
were never called upon to store a large amount of text. 

ChildWndProc() calls GlobalAllocf) with the value GHND for 
the flags parameter. This equates to GMEM_ZEROINIT | 
GMEM_MOVEABLE. I mentioned earlier that the global block should 
be initialized to zeros. This is not strictly true. Because the edit 
control treats the global block as if it were a task’s data segment, 
and Windows maintains data in the first 16 bytes, only the first 
16 bytes must be initialized to zero. In particular, Windows uses 
the word at byte 6 as a near pointer to the beginning of the 
local heap in the global block. During initialization, the edit control 
checks this location for zero, to see if a local heap has been 
created for the global block. If byte 6 is zero, the edit control calls 
LocalInit() to create a local heap; otherwise, it assumes one 
exists already. If the word at location 6 contains garbage when 
you call CreateWindow() for the edit control, the local memory 
manager can become very unhappy. 

The other procedure of interest, TestSetHandlef), exercises 
the EM_SETHANDLE message. It sets a new buffer for the edit con¬ 
trol, initialized to the contents of the string. After obtaining the 
window handle of the edit control in the active MDI window, 
TestSetHandlef) calls EM_GETHANDLE to obtain the current buff¬ 
er. The application must free this handle to avoid a memory leak. 
Calling Local Free () at this point will not work, however, since 
the value in DS (the data segment register) is for the application’s 
default data segment. The next few lines of code save away the 
current value in DS, then load it with the edit control’s global 
block handle, via its hInstance-. 

wDS = GetWindowInstance(hwnd); 

_asm push ds; 

_asm mov ds, wDS; 

You can then free the local handle and allocate another 
from the edit control's local heap. You might wonder about 
the call to IstrcpyO I use to copy the text into the new edit 
control memory. The far pointer to the string to copy is okay, 
but an explicit far pointer is constructed for the edit’s new 
buffer from the near pointer, pch. This avoids compiler de¬ 
pendence by ensuring that the selector value is the current DS 
and not SS. After the last call to the local memory manager, 
TestSetHandle() restores DS to the task's data segment, and 
installs the new buffer, sending the edit control the 
EM SETHANDLE message. 
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Listing 4 model ess. c — Sample main program for 
modeless common dialogs 


^******* ********** ********************** **************j 


/* modeless.c */ 
/* - Demonstrates modeless common dialogs. */ 
/* - To compile: */ 
/* cc modeless.c modeless.rc toolhelp.lib */ 


^*****************************************************j 

♦include <windows.h> 

♦include <windowsx.h> 

♦include <commdlg.h> 

#include <toolhelp.h> 

♦ include "modeless.h" 

LRESULT CALLBACK _export LWndProc(HWND, UINT. WPARAM, LPARAM); 
BOOL FHook(HWND, UINT, WPARAM, LPARAM); 

BOOL ModelessChooseFont(HWND); 

char szApp[] • "Modeless"; /* App's name. */ 

HWND hwndEdit; /* Edit control */ 

♦define didEdit 1 /* Edit control id. */ 

♦define didApply 0x402 /* Apply button id. */ 

♦ifdef _BORLANDC_ 

♦pragma argsused 
♦endif 

int PASCAL WinMain(HIN$TANCE hins, HINSTANCE hinsPrev, 

LPSTR lsz, int wShow) 

( 

MSG msg; 

HWND hwnd; 

if (hinsPrev -■ NULL) 

{ 

WNDCLASS wcs; 

wcs.style = CS_HREDRAW | CSJREDRAW; 
wcs.lpfnWndProc * LWndProc; 
wcs.cbClsExtra = 0; 
wcs.cbWndExtra = 0; 
wcs.hlnstance * hins; 

wcs.hlcon - LoadIcon(NULL, IDIAPPLICATION); 
wcs.hCursor = LoadCursor(NULL, IDC_ARR0W); 
wcs.hbrBackground = (HBRUSH)(COLOR WINDOW + 1); 
wcs.lpszMenuName = MAKEINTRESOURCElmidFonts); 
wcs.lpszClassName = szApp; 
if (!RegisterClass(&wcs)) 
return 0; 

) 

msg.wParam = 0; 

if ((hwnd - CreateWindow(szApp, "Modeless Common “ 

"Dialog Demo", WS OVERLAPPEDWINDOW, CW_USEDEFAULT, 
CW_USEDEFAULT, CW _ USEDEFAULT, CWJSEDEFAULT, 

NULL, NULL, hins,~NULL)) != NULL) 

{ 

ShowWindowfhwnd, wShow); 

while (GetMessage(&msg, NULL, 0, 0)) 

( 

TranslateMessage(&msg); 

DispatchMessage(taisg); 

} 

) 

return msg.wParam; 

) 

LRESULT CALLBACK _export LWndProc(HWND hwnd, UINT wm, 

WPARAM wParam, LPARAM IParam) 

{ 

switch (wm) 

{ 

default: 

break; 

case WM_CREATE: 

if ((hwndEdit * CreateWindow("edit", "Type here", 

WS CHILD 1 WS VISIBLE | WSJSCROLL | 
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Q Do you know if and how one could use the common 
dialog routines as modeless (versus modal) dialogs? 

Jon Carlson 
CompuServe: 71042,744 

A A modal dialog provides its own message loop and does 
not return control to the caller until the user dismisses 
the dialog. A modeless dialog draws itself and returns control 
to the caller, then functions like an ordinary window, just ser¬ 
vicing whatever messages the caller's message loop dis¬ 
patches to it. Modeless dialogs can be preferable to modal 
dialogs, since they let your program retain control. For ex¬ 
ample, you could structure your program so as to make a 
modeless dialog retain the input focus until the user com¬ 
pleted it, but still perform background processing in your main 
loop during idle moments. 


Of the nine common dialog routines, seven are modal (Find 
and Replace are the exceptions). You can make the seven 
modal common dialogs behave modelessly, but the task is 
not trivial. You could approximate a modeless dialog by in¬ 
stalling a hook callback and re-enabling the owner window on 
receipt of a UM_INITDIALOG message, but as far as the pro¬ 
gram is concerned, control (the message loop) will still be in¬ 
side the call to the common dialog routine (e.g., Choose- 
Font()). You could try something monstrously kludgy, like a 
call to Catch () before the call to the common dialog routine, 
then a Throw() from inside an installed hook callback, but this 
is, well, monstrously kludgy, and there is a better way. 

Under Windows NT, which is a multithreading environment, 
you could call the common dialog routine from a separate 
thread. Even though Windows 3.1 is not multithreading, you 
can still create another task to run the dialog. This is not as 
bad as it sounds. Interprocess communication is very easy to 
accomplish in Windows - you do not have to resort to a for¬ 
malized protocol such as DDE. Instead, you can use Send- 
Message() and PostAppMessage() to communicate with the 
second program. Also, starting a second 
program to provide a separate thread of 
control need not be inefficient. In the ex¬ 
ample I constructed, the "server thread” 
program’s executable is only about 3Kb 
large, and it loads and executes very 
quickly. 

Using this approach, I wrote mode¬ 
less, c (Listing 4) to display a modeless 
version of the Choose Font dialog. The 
program Fills its client area with a multi- 
line edit control and possesses a single 
menu item, Choose Fonts, on its menu 
bar-, clicking it invokes the dialog. You 
can click it multiple times to create mul¬ 
tiple Choose Font dialogs, modeless.h 
(Listing 5) defines a couple of menu con¬ 
stants and modeless.rc (Listing 6) is the 
resource File for the menu, dlgservr.c 
(Listing 7) implements the dialog server 
that actually invokes the dialog. Figure 2 
outlines the general scheme used to 
turn a modal dialog box into a modeless 
dialog box. 

Each time modeless.exe wants to 
display a copy of the Choose Font dialog, 
it calls ModelessChooseFont () which in 
turn calls UinExecf) to create a new in¬ 
stance of the dialog server. The dialog 
server is not your average Windows pro¬ 
gram. It sits in a loop looking for a 
WMUSER message. When it receives one, 
it calls ChooseFontf), and then exits 
when ChooseFont() returns. It may 
seem odd to enter a message loop 
before creating any windows for a task, 
but you can use the Windows function 
PostAppMessage() to deliver a message 


Figure 2 Making a modal dialog modeless 


modeless.exe 
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Listing 4 continued 


ES MULTILINE, 0, 0, 0, 0, hwnd, 

BOOL FHook(HWND hwnd, UINT wm, WPARAM wParam, LPARAM 1Param) 

(HMENU)didEdit, GetWindowInstance(hwnd), 

^***************************************************** j 

NULL)) -= NULL) 

/* - ChooseFont dialog filter. */ 

return -1; 

/★★***************************************************y 

break; 

( 

LOGFONT gft; 

case WM SIZE: 

static HFONT hfnt; 

SetWindowPos(hwndEdit, NULL, 0, 0, 

HFONT hfntNew; 

LOWORD(IParam), HIW0RD(1Param), 


SWP NOACTIVATE | SWP NOMOVE | SWP N0Z0R0ER); 

if (wm == WM INITDIALOG) 

break; 

{ 

EnableWindow(GetWindowOwner(hwnd), TRUE); 

case WM COMMAND: 

return TRUE; 

if (wParam == idmFonts) 

) 

ModelessChooseFont(hwnd); 


break; 

if (wm != WM_COMMAND || 

! (wParam •« didApply || wParam == IDOK) ) 

case WM DESTROY: 

return FALSE; 

PostQuitMessage(O); 


break; 

SendMessage(hwnd, WM CHOOSEFONT GETLOGFONT, 0, 

(LPARAM)(LPLOGFONTligft); 

case WM USER: 

if ((hfntNew * CreateFontIndirect(&gft)) ! = NULL) 

return FHook ((( LPMSG)1Param)->hwnd, 

( 

( (LPMSG)1Param)->message. 

SendMessage(hwndEdit, WM SETFONT, 

( (LPMSG)1Param)->wParam, 

(WPARAM)hfntNew, TRUE); 

(( LPMSG)1Param)->1Param); 

if (hfnt != NULL) 

) 

DeleteObject(hfnt); 
hfnt = hfntNew; 

return DefWindowProc(hwnd, wm, wParam, 1Param); 

} 

( 

return wParam == didApply; 
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directly to a task instead of one of the 
task's windows. This is what Modeless- 
ChooseFontf) does after creating a new 
dialog server task. It then posts 
WM_USER, along with the address of the 
CH00SEF0NT structure passed via l- 
Param. 

modeless, c uses GMEM_SHARE to allo¬ 
cate space for the CH00SEF0NT structure 
(ModelessChooseFont() makes the 
block large enough to contain the LOG- 
FONT and typeface string as well). This 
lets the dialog server safely free the 
memory after the Choose Font dialog 
terminates. In Windows 3.1, it turns out, 
a task can successfully free a global 
handle allocated in another task, even if 
the original task did not use 
GMEM_SHARE. (Though 3.1 does not re¬ 
quire the use of GMEM_SHARE for such al¬ 
locations, future versions of Windows 
may.) 

PostAppMessage() requires a task 
handle to identify the recipient but un¬ 
fortunately UinExec() returns an in¬ 
stance handle. You can use the Tool- 
help ( toolhelp.dll ships with Win¬ 
dows 3.1) functions TaskFirst() and 
TaskNext() to walk the task list to find 
the task whose instance handle 
matches that returned by WinExec(). 

This technique for turning modal 
dialogs into modeless dialogs is compli¬ 
cated by the need to handle callback 
functions. The common dialogs let you 


specify a callback function that you can 
use to tailor the behavior of the dialogs. 
The problem here is that while the 
dialog server application controls the 
common dialog, the callback procedure 
resides in the modeless application. 

Therefore, before calling Choose- 
Font(), the dialog server installs its 
own callback function ( UHook()) in the 
IpfnHook field of the CH00SEF0NT struc¬ 
ture. There is a good reason for this. If 
the common dialog was allowed to call 
directly to a function in modeless.exe, 
that function would be operating within 
the context of the dialog server. In 
other words dlgservr.exe - not mode¬ 
less.exe - would be the current task, 
and SS would then select the dialog 
server’s stack. You could overcome this 
by using an instance thunk as the 
callback's address (so that DS would be 
correct) and switching stacks (so that SS 
equals DS), but this is a dirty job and 
hard to get right. 

Instead, dlgservr.c uses Send- 
Message() to deliver a private MM_USER 
message to the dialog's owner window. 
SendMessageO works well here for two 
reasons: first, dlgservr.c can treat it as 
a function call (which allows me to pass 
the address of automatic data); second, 
and even more important, Send¬ 
MessageO will switch tasks to deliver 
the message, and switch back before it 
returns. It is important to note that 
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Listing 4 continued 


) 

sizeof(CHO0SEF0NT) + sizeof(L0GF0NT) + 

LF FACESIZE)) == NULL) 

BOOL ModelessChooseFont(HWND hwnd) 

I 

^***************************************************** i 

TerminateApp(tsk.hTask, NO UAE BOX); 

/* - Display the choose font common dialog. */ 

return FALSE; 

/* - Create another task to carry out this request. */ 

/* - hwnd : Owner window for dialog. */ 

i 

y***************************************************** j 

lpcsf->lStructSize = sizeof(CH00SEF0NT); 

i 

lpcsf->hwnd0wner = hwnd; 

HINSTANCE hi ns; 

lpcsf->lpLogFont * (LPL0GF0NT) (( LPBYTE)1pcsf + 

TASKENTRY tsk; 

sizeof(CHOOSEFONT) ) ; 

LPCHOOSEFONT lpcsf; 

lpcsf->Flags - CF SCREENF0NTS | CF EFFECTS | 

CF APPLY | CF ENABLEH00K | 

if ( (hins - (HINSTANCE)WinExec("dlgservr.exe“, 0)) 

CF INITT0L0GF0NTSTRUCT | CF USESTYLE | 

< HINSTANCE ERROR) 

CF F0RCEF0NTEXIST; 

return FALSE; 

lpcsf->lpszStyle - (LPSTR)lpcsf->lpLogFont + 
sizeof(LOGFONT) ; 

/* Find task. Return false if we can't find it. */ 
tsk.dwSize = sizeof tsk; 

lpcsf->nFontType = SCREEN_F0NTTYPE; 

if ( ITaskFirst(&tsk) ) 

/* Store pointer here so it gets passed to hook */ 

return FALSE; 

/* via WM INITDIAL0G. */ 

do 

if (tsk.hlnst == hins) 

lpcsf->lCustData = (LPARAM)lpcsf; 

break; 

PostAppMessage(tsk.hTask, WM USER, 0, 

while (TaskNext(&tsk) ); 

(LPARAM)1pcsf); 

if (tsk.hlnst !- hins) 

return TRUE; 

return FALSE; 

i 

/* Get block big enough for CHO0SEF0NT, L0GF0NT, */ 

/* and IpszStyle string. */ 

if ((lpcsf = G1 obalA11ocPtr(GHND | GMEM_SHARE, 

/* End of File */ 


Notice to Our 
Subscribers 

Occasionally, Windows/DOS 
Developer’s Journal makes its 
mailing list available to vendors 
of products we think our 
readers will find interesting. Cur¬ 
rent subscribers receive free in¬ 
formation in the mail from 
these vendors. 

If you prefer that your name 
not be used in these mailings, 
please let us know. Just copy or 
clip this form and send it with 
your name and address to: 


Windows/DOS 

□ DEVELOPER'S JOURNAL 

1601 W. 23rd. St, Suite 200 
Lawrence, KS 66046-2743 


ADVANCED. SERIOUS. TECHNICAL. 


Windows/DOS 

□ DEVELOPER'S JOURNAL 

If you’re reading this journal, you’re among a select group of advanced 
programmers worldwide who program professionally for Windows and DOS. 

Come meet fellow programmers, writers, 
and Windows/DOS Developer’s Journal 
representatives at the 


SOFTWARE 
DEVELOPMENT ’93 
August 24-26 

BOSTON, MASSACHUSETTS 


Stop by Booth 426 for 
information and prizes. 

For more information call: 

913 - 841-1631 


We look forward to seeing you there! 


July 1993 


Windows/DOS Developer's Journal - Page 85 













CallWindowProc() does not provide this functionality. The 
original message parameters received by MHookf) are repack¬ 
ed into a MSG structure whose address is delivered with the 
MM USER message. When model ess. c receives a MM_USER mes¬ 
sage, it unpacks the fields of the MSG structure and calls its 
version of a Choose Font hook callback, FHook(). 

FHook() is a sample callback for demonstration purposes. 
On receipt of the UM_INITDIALOG message, it re-enables its 
owner window (disabled by the Windows dialog manager) and 
returns TRUE, so that the dialog manager will set the focus to 
a control in the dialog. LUndProcf) returns the value of 
FHook() from the MMJJSER message. SendMessage() returns 
this value to the dialog server's UHook(), which in turn returns 
it to the common dialog DLL. When FHook() gets a UM_COM- 
MAND for either the Okay or Apply buttons, it obtains the cur¬ 
rent font from the dialog with the UM_CHOOSEFONT_GETLOGFONT 
message, creates a font from the resulting LOGFONT data, and 
selects the font into the multi-line edit control. 

modeless.c passes its main window handle to dlgservr.c 
via the CHOOSEFONT structure and this window becomes the 
owner of the dialog. The window manager in USER gives spe¬ 
cial treatment to an owned popup window. When the owner 
is hidden or iconized, the owned window is hidden. In Win¬ 
dows 3.1, intertask window ownership appears to work, but 
this could prove to be a problem under Windows NT. If so, 
you could pass NULL for the owner window, and make up for 
the lost user interface functionality by adding code to handle 
the MM_ACTIVATE message. Figure 3 shows the demonstration 
program in action. 


Listing 5 model ess. h - Constants for modeless.c 


I*****************************************************j 

/* modeless.h */ 

/* - Menu ids for modeless common dialog demo. */ 

^**************************************** *************j 

Idefine midFonts 1000 /* Menu id. */ 

Idefine idmFonts 2000 /* Menu item id. */ 

/* End of File */ 


Listing 6 model ess. rc - 
modeless.c 

Resource definitions for 

/*****************************************************/ 

/* model ess.rc 

*/ 

/* - Menu resource for modeless 

common dialog demo. */ 

J*****************************************************j 

linclude <window$.h> 


linclude "modeless.h“ 


midFonts MENU 


BEGIN 


MENUITEM "SChoose font.. 

.idmFonts 

END 



The technique I have presented should be extensible to 
the other six modal common dialogs. In fact, you can apply it 
to message boxes as well. A modeless message box can 
sometimes be a handy alternative to tear-off menus. You can 
change the text of the button controls in the message box to 
whatever you want (once you know the message box's win¬ 
dow handle) by using GetDlgltemf) with the various ID con¬ 
stants (e.g., IDOK). You can obtain the message box's window 
handle by enumerating the task windows of the server task. 
This is pretty easy since EnumToskWindows() only enumerates 
top-level and popup windows, and the server task will have 
only one of those. □ 


Listing 7 dlgservr.c — Server program for 
modeless common dialogs 


/*****************************************************J 


/* dlgservr.c */ 
/* - Modeless common dialog server. */ 
/* - To compile: */ 
/* cc dlgservr.c commdlg.lib */ 


J*****************************************************j 

linclude <windows.h> 
linclude <windowsx.h> 
linclude <commdlg.h> 

HINT CALLBACK _export WHook(HWND, UINT, WPARAM, LPARAM); 

lifdef _BORLANDC_ 

Ipragma argsused 
lendif 

int PASCAL WinMain(HINSTANCE hins, HINSTANCE hinsPrev, 

LPSTR lsz, int wShow) 

( 

MSG msg; 

while (GetMessage(&msg, NULL, 0, 0)) 
if (msg.message == WMJJSER) 

( 

((LPCH00SEF0NT)msg.1Param)->1pfnHook = 

WHook; 

ChooseFont((LPCHOOSEFONT)msg.1Param); 

G1 obalFreePtr(msg.1Param); 
break; 

) 

return 0; 

} 

UINT CALLBACK _export WHook(HWND hwnd, UINT wm, 

WPARAM wParam, LPARAM 1Param) 

f*****************************************************f 

/* - Relay messages to client's hook function. */ 

j ********** ************************** ********** *******j 
{ 

MSG msg; 

msg.hwnd = hwnd; 
msg.message » wm; 
msg.wParam = wParam; 
msg.1Param ■ 1Param; 

return (UINT)SendMessage(GetWindowOwner(hwnd), 

WMJJSER, 0, (LPARAM)(LPMSG)Smsg); 

} 

/* End of File */ 
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Reader-Contributed Tricks and Hacks 



Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks —those 
clever pieces of code to 
make things work the 
wag they should! You'll 
receive at least $50 for 
each tip that we print 
Send your submissions to.- 
Tech Tips 
Leor Zolman 
74 Marblehead Street 
North Reading, MA 01864 
leor@bdsoft.com. 


Handling Volume Labels and 
Previous Instances Revisited 


C Library for Remove and Set Disk 
Volume Label for MS-DOS 

Smuth Nakpansua 
Telbiz Co Ltd. 
49 Pra-Atit Road, 
10200 Bangkok, THAILAND 


DOS's volume labels are implemented as a special 
type of entry in a disk’s root directory. The entry con¬ 
tains a time-and-date stamp and has an attribute 
value of 8 (bit 3 set). Except for the attribute, a volume 
label is identical to the directory entry for a file that 
was created but never had any data written into it, and you can manipulate volume 
labels with Int 21H functions much as you manipulate files. 

You can create a volume label using the Create File function (Int 21H Function 
3CH) with an attribute of 8, you can use the Find First File function (Int 21H Func¬ 
tion 4EH) to obtain an existing volume label, and you can use the Rename File 
function (Int 21H Function 17H) to rename an existing volume. You can also 
remove a volume label with the Delete File function (Int 21H Function 13H). 

I've never seen documentation on the usage of the extended file control block 
(XFCB) in conjunction with the Rename File function (Int 21H Function 17H) in any 
magazine or book. However, I tried to use it and I found that the 16 bytes after the 
"name” is the “new-name." 

I’m submitting two commands, setlabel.c (Listing 3) and rmlabel.c (Listing 4), 
for setting and deleting a volume label, respectively. Listing 1 shows the common 
header file dsklabel.h, and Listing 2 is the common function library shared by the 
two commands. 



Leor Zolman wrote BDS Q the first C compiler targeted exclusively for personal computers. 
Leor is currently an instructor on UNIX topics for Boston University’s Corporate Education 
Center, a regular contributor to The C Users Journal and Sys Admin magazines, and “Tech 
Tips" editor for Windows/DOS Developer's Journal. His first book. Illustrated C, was publish¬ 
ed by R&D Publications, Inc in 1992. He may be contacted at 74 Marblehead St, North 
Reading, MA 01864, or on Usenet/Internet as.- Jeor@bdsoft.com. 



















Listing 1 dsklabel.h 


DskLabel.H - Remove & Set Disk Volume Label for DOS 
Copyright (c) Smuth Nakpansua, 1992, 1993. 

All rights reserved. 

Create date: Nov 25, 1992 
Last Update: March 23, 1993 


*/ 


#ifndef _DSKLABEL_H_ 

Idefine _DSKLABEL_H_ 

Ipragma pack(l) 

typedef struct _tagXFCB { /* 


char flag; /* 

char reservedl[5]; /* 

unsigned char attr; /* 

char drive; /* 

char name[8]; /* 

/* 

char ext [3]; /* 

short cur_block; /* 

short recsize; /* 

long filesize; /* 

struct { 


unsigned day : 5; 
unsigned month : 4; 
unsigned year : 7; 

) ldate; /* 
struct { 

unsigned sec : 5; 
unsigned min : 6; 
unsigned hour : 5; 


} ltime; /* 

char reserved2[16]; /* 

char cur_rec; /* 

char relate_rec; /* 

} XFCB; 


Extened File Control Block */ 
-1 for extended FCB */ 
must be zero */ 
attribute byte */ 

0=default, 1=A, 2*B, etc */ 
file & extension name */ 
must be left justified */ 
and padded with blanks */ 
current-block number */ 
record size */ 
file size */ 


date created/updated */ 


time created/updated */ 
must be zero */ 
current record number */ 
relative-record number */ 


#pragma pack() 

int _DosRemoveVolumeLabel(int DrvNum); 

int _DosSetVolumeLabel(int DrvNum, char *VolumeName); 

#endif /* _DSKLABEL_H_ */ 

/* End of File */ 


Mr. Nakpansua's code is fully generalized to run under 
either the Microsoft or Borland family of compilers. Code 
like this makes my job really easy; it all compiled exactly as 
submitted under both Microsoft C 8.0 and Borland C++ 3.1 
— without even so much as a warning. — Iz 



The Return of Returning to Previous Instances 


James K. Lawless 
1622 Ave. F 
Council Bluffs, IA 51501 


The May Tech Tips column contains a tip from David Spec- 
tor pertaining to applications that restart an original instance 
when other instances of the given application are invoked. 

David says that although the task sounds simple, there’s 
no Windows function to do it. He then provides an elaborate 
method of searching all top-level windows to determine if the 
value of given window structure’s hlnstonce member 
matches the hPrevInst parameter passed to UinMainj). 

A simpler solution does exist, although the sheer number 
of functions, macros, and structures involved in writing Win¬ 
dows application sometimes causes one to overlook the 
simplest solution. 

A little Windows function known as GetInstanceData() al¬ 
lows an application to retrieve a variable from a past incarna¬ 
tion of itself. To use this function for David’s purpose, I 
modified the WHELLO program (Listings 5-7, adapted from Char¬ 
les Petzold's Programming Windows 3.1) so that the main win¬ 
dow handle gets tucked away in the global variable _hMain- 
Und. 

All that a secondary instance of the given application has 
to do is call GetlnstanceDataf) to obtain the previous 
instance’s value of _hMainUnd. Then, the application simply fol¬ 
lows David's original code to restore an iconic window and 
pass control to the original instance. 

I find this method preferable to the original since it re¬ 
quires fewer lines of code and eliminates the need for a 
brute-force search of all top-level windows. 


Listing 2 dsklabel.c 

/* 


DskLabel.C - Remove & Set Disk 

Volume Label for DOS 

Copyright (c) Smuth Nakpansua, 

1992, 1993. 

All rights reserved. 


Create date: Nov 25, 1992 


Last Update: March 23, 1993 


Compile: cl /c dsklabel.c 

(Microsoft) 

bcc /c dsklabel.c 

(Borland) 

*/ 



Figure 1 Sample output from 

vformat.exe 

l 

1.00 

2 

2.00 

3 .... 

.... 3.00 

4 

4.00 

5 

5.00 

6 .... 

.... 6.00 

7 

7.00 

8 

8.00 

9 .... 

.... 9.00 

10 

10.00 
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Listing 2 continued 


linclude <dos.h> 

#include <io.h> 
linclude <conio.h> 
linclude <stdio.h> 
linclude <stdlib.h> 
linclude <string.h> 

lifdef _TURBOC_ 

linclude <dir.h> 

lelse /* for Microsoft C */ 

linclude <direct.h> 

lendif 

linclude "dsklabel.h“ 

int _DosRemoveVolumeLabel(int DrvNum) 

( 

char disktransfer[80]; /* buffer to DTA */ 

union REGS r; 
struct SREGS s; 

char cwd[90]; /* current work directory */ 

void far * oldDTA; /* old disk transfer area */ 

XFCB xfcb; 
int result ■ 0; 
int OldDrv = 0; 

if (DrvNum ■« 0) /* for current drive, get drive number */ 

lifdef _TUR80C_ 

DrvNum = getdisk() + 1; /* 0=A, 1=B, etc */ 

lelse 

DrvNum = _getdrive(); /* 1=A, 2=B, etc */ 

lendif 

else /* else save current drive */ 

lifdef _TURBOC_ 

OldDrv ■ getdiskO; /* 0=A, 1=B, etc */ 

lelse 

OldDrv = _getdrive(); 

lendif 

lifdef_TURBOC_ 

getcurdir(DrvNum, cwd); /* save current work directory */ 
setdisk(DrvNum - 1); /* change drive to DrvNum */ 

lelse 

_getdcwd(DrvNum, cwd, sizeof(cwd)); /* save current work directory */ 
_dos_setdrive(DrvNum, &r.x.ax); /* change drive to DrvNum */ 
lendif 

sprintf(disktransfer, "%c:\\“, DrvNum + 'A' - 1); /* make ROOT directory */ 

chdir(disktransfer); /* set to ROOT */ 

r. h.ah = 0x2f; /* get DTA address, return in ES:BX */ 

intdosx(&r, &r, &s); /* call int 21h */ 

lifdef _TURBOC_ 

oldDTA * MK_FP(s.es, r.x.bx); 
lelse 

FP_SEG(oldDTA) = s.es; /* save it 
FP_0FF(oldDTA) = r.x.bx; 
lendif 

segread(&s); /* get current segment register */ 

s. ds » s.ss; /* point DS:DX to @disktransfer */ 

r.x.dx « (unsigned short)disktransfer; 

r.h.ah * Oxla; /* set DTA address to DS:DX */ 

intdosx(&r, &r, &s); /* call int 21h */ 

memset((void *)&xfcb, 0, sizeof(xfcb)); 

memset((void *)xfcb.name, '?', sizeof(xfcb.name)+sizeof(xfcb.ext)); 
xfcb.flag = -1; /* flag signifying extended FOB */ 

xfcb.attr = 8; /* volume attribute byte */ 

xfcb.drive = (char)DrvNum; /* drive number 1=A, 2=B, etc */ 
r.h.ah = Oxll; /* search for first match */ 

r. x.dx = (unsigned short)&xfcb; 
segread(Ss); 

s. ds - s.ss; 

intdosx(&r, &r, &s); /* call int 21h */ 

if (r.h.al •» 0) ( /* found exists volume label, delete */ 
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Listing 2 continued 


strncpy(xfcb.name, (char *)((XFCB *)disktransfer)->name, sizeof(xfcb.name) + 
sizeof(xfcb.ext)); 

r.h.ah = 0x13; /* delete file */ 

r. x.dx = (unsigned short)&xfcb; 

segread(&s); /* point DS:DX to extended FCB for rename file */ 

s. ds = s.ss; 

intdosx(&r, &r, &s); /* call int 21h */ 

result = (int)r.h.al; 

} /* if, else do nothing */ 

/* restore DTA */ 
s.ds = FP_SEG(oldDTA); 
r.x.dx = FP_0FF(oldDTA); 

r.h.ah = Oxla; /* set DTA address to DS:DX */ 

intdosx(&r, &r, &s); /* call int 2lh */ 

if (OldDrv) /* if changed current drive */ 

#ifdef TURBOC 


setdisk(OldDrv); /* change drive to DrvNum */ 


#el se 


_dos_setdrive(OldDrv, &01dDrv); 

#endif 

chdir(cwd); /* restore active directiry */ 

return(result); /* return 0 if OK, else error */ 

} /* eof: _DosRemoveVolumeLabel() */ 


int _DosSetVolumeLabel(int DrvNum, char *VolumeName) 

{ 

char disktransfer[80]; /* buffer to DTA */ 

union REGS r; 
struct SREGS s; 

char cwd[90]; /* current work directory */ 

void far * oldDTA; /* old disk transfer area */ 

XFCB xfcb; 

int result « 0; 

int len = strlen(VolumeName); 

int OldDrv = 0; 


if (IVolumeName || len *■ 0) /* if invalid name */ 

return(-l); 

if (len > 11) /* longer than DOS limited, 11 bytes */ 

len = 11; 

if (DrvNum == 0) /* for current drive, get drive number */ 

#ifdef _TURBOC_ 

DrvNum = getdisk() + 1; /* 0=A, 1=B, etc */ 

lelse 

DrvNum » _getdrive(); /* 1=A, 2=B, etc */ 

lendif 

else /* else save current drive */ 

#ifdef _TURBOC_ 

OldDrv = getdiskO; /* 0=A, 1=B, etc */ 

#el se 

OldDrv = _getdrive(); 

lendif 

#ifdef _TURBOC_ 

getcurdir(DrvNum, cwd); /* save current work directory */ 
setdisk(DrvNum - 1); /* change drive to DrvNum */ 

#el se 

_getdcwd(DrvNum, cwd, sizeof(cwd)); /* save current work directory */ 
_dos_setdrive(DrvNum, &r.x.ax); /* change drive to DrvNum */ 
lendif 

sprintf(disktransfer, "%c:\\", DrvNum + 'A' - 1); /* make ROOT directory */ 

chdir(disktransfer); /* set to ROOT */ 

r.h.ah = 0x2f; /* get DTA address, return in ES:BX */ 

intdosx(&r, &r, &s); /* call int 21h */ 

lifdef _TURBOC_ 

oldDTA = MK_FP(s.es, r.x.bx); 
lelse 

FP_SEG(oldDTA) = s.es; /* save it */ 

FP_OFF(oldDTA) = r.x.bx; 
lendif 

segread(Ss); /* get current segment register */ 


Using Dynamic Format 
Strings with printfO 

John N. Power 
POWER TECHNOLOGIES 
Suite 110-387 
4132 Joppa Road 
Baltimore, MD 21236 

Most programmers probably know 
that a function that takes a pointer to a 
character string can also be passed a 
literal string as an argument. For ex¬ 
ample, a function declared as 

func(char *ptr) 

can be called with 

func("This is a string") 

The compiler creates a nul (-terminated 
character array in the data segment 
and compiles the call with the array's 
address. 

The opposite is also true; functions 
such as printfO that are typically 
called with literal strings can also be 
called with pointers to arrays. This can 
be useful when complex formatting 
procedures are required or when many 
occurrences of the same format string 
would cause excessive memory use. 

Listing 8 shows two examples in 
which pointer arithmetic simplifies out¬ 
put. The program prints two columns of 
numbers, the first containing the in¬ 
tegers from one to ten, and the second 
having the equivalent values in floating¬ 
point format (Figure 1 shows the out¬ 
put). To make it easier to correlate the 
numbers in the two columns, it is con¬ 
venient to have a lead-in line from 
column one to column two every 
several lines. The fill characters be¬ 
tween the columns are selected accord¬ 
ing to the line number, using the fact 
that a test for equality returns either 
zero or one, depending on whether the 
comparison fails or succeeds. 

The second example is in the func¬ 
tion outnum(). In this case, the output 
format is selected by a variable passed 
from main(). outnum() receives its out¬ 
put parameter in a union, allowing the 
function to process both integer and 
floating-point variables with a minimum 
of code. Note that the union must be 
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Listing 2 



s.ds = s.ss; /* point DS:DX to Odisktransfer */ 

r.x.dx = (unsigned short)disktransfer; 
r.h.ah = Oxla; /* set DTA address to DS:DX */ 

intdosx(&r, Sr, Ss); /* call int 21h */ 
memset(Sxfcb, 0, sizeof(xfcb)); 

memset(xfcb.name, sizeof(xfcb.name)+sizeof(xfcb.ext)); 

xfcb.flag = -1; /* flag signifying extended FCB */ 

xfcb.attr = 8; /* volume attribute byte */ 

xfcb.drive = (char)DrvNum; /* drive number 1=A, 2=B, etc */ 
r.h.ah = Oxll; /* search for first match */ 

r. x.dx = (unsigned short)Sxfcb; 
segread(Ss); 

s. ds = s.ss; 

intdosx(Sr, Sr, Ss); /* call int 21h */ 

if (r.h.al == 0) ( /* found exists volume label, rename */ 

strncpy(xfcb.name, ((XFCB *)disktransfer)->name, sizeof(xfcb.name) + 
sizeof(xfcb.ext)); 

memset(xfcb.name+16, ' ', sizeof(xfcb.name) + sizeof(xfcb.ext)); 
strncpy(xfcb.name+16, VolumeName, len); 
r.h.ah = 0x17; /* rename file */ 

r. x.dx = (unsigned short)Sxfcb; 

segread(Ss); /* point DS:DX to extended FCB for rename file */ 

s. ds = s.ss; 

intdo$x(Sr, Sr, Ss); /* call int 21h */ 

result = (int)r.h.al; 

} /* if */ 

else ( /* else create */ 

char vol[12]; 

strncpy(vol, VolumeName, 11); 
if (strchr(vol, '.') «= NULL SS len > 8) ( 

/* if length of filename > 8, must insert '.' 
strncpy(vol, VolumeName, 8); 
vol[8] = ’.'; 

strcpy(vol + 9, VolumeName + 8); 

) 

else 

strcpy(vol, VolumeName); 
r.h.ah = 0x5b; /* create new file */ 

r.x.cx ■ 8; /* volume label bit set */ 

r. x.dx = (unsigned short)vol; 
segread(Ss); 

s. ds » s.ss; 
intdosx(Sr, Sr, Ss); 
result - r.x.cflag ? -1 : 0; 

if (Iresult) { /* can open, close */ 

r.h.ah = 0x3e; /* close file */ 

r.x.bx = r.x.ax; 
intdosx(Sr, Sr, Ss); 

) /* if */ 

) /* else */ 

s.ds = FP_SEG(oldDTA); 

r.x.dx = FP_OFF(oldDTA); 

r.h.ah = Oxla; /* set DTA address to DS:DX */ 

intdosx(Sr, Sr, Ss); /* call int 21h */ 
if (OldDrv) 
lifdef _TURBOC_ 

setdisk(OldDrv); /* change drive to DrvNum */ 

#else 

_dos_setdrive(OldDrv, SOldDrv); 

lendif 

chdir(cwd); 
return(result); 

) /* eof; _DosSetVolumeLabel() */ 

/* End of File */ 
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defined containing a double, not a float, since printfO as¬ 
sumes parameters of type float have been automatically 
promoted to type double when passed. Pushing the union by 
value does not cause type conversion, so the union must be 
defined with the type expected by the called program. The 
same applies to char variables, which must be defined as int. 
This works since all members of a union are guaranteed to 
align with each other and with the beginning of the union. 
The union must be the last parameter passed, otherwise the 
following parameters may not be correctly located on the 
stack. 


While this example may not necessarily represent the 
simplest way to generate a multicolumn table with variable 
formatting, the technique does serve as a wake-up call to 
those of us who have never considered passing anything 
other than a literal string as the first parameter to printf(). 
Expanding on what Mr. Power puts forth above, this techni¬ 
que might allow cleaner solutions to complex formatting 
problems than the conventional approach of using multiple 
if statements and/or tertiary conditional operators (?:) 
within printf calls to achieve similar results. — Iz 


Listing 3 setlabel.c 


Listing 4 rmlabel.c 

/* 


/* 

SetLabel.C - Set Disk Volume Label for DOS 


RmLabel.C - Remove Disk Volume Label for DOS 

Copyright (c) Smuth Nakpansua, 1992, 1993. 


Copyright (c) Smuth Nakpansua, 1992, 1993. 

All rights reserved. 


All rights reserved. 

Create date: Nov 25, 1992 


Create date: Nov 25, 1992 

Last Update: March 23, 1993 


Last Update: March 23, 1993 

Compile: cl setlabel.c dsklabel.obj (Microsoft) 


Compile: cl rmlabel.c dsklabel.obj (Microsoft) 

bcc setlabel.c dsklabel.obj (Borland) 


bcc rmlabel.c dsklabel.obj (Borland) 

*/ 


*/ 

linclude <dos.h> 


linclude <dos.h> 

linclude <io.h> 


linclude <io.h> 

linclude <conio.h> 


linclude <conio.h> 

linclude <stdio.h> 


linclude <stdio.h> 

linclude <stdlib.h> 


linclude <stdlib.h> 

linclude <string.h> 


linclude <string.h> 

linclude "dsklabel .h' 1 


linclude "dsklabel.h" 

int main(int argc, char **argv) 

/ 


int main(int argc, char **argv) 

/ 

l 

int drive; 


int drive; 

printf("SetLabel - Set Label Uti1ity\n" 


printf("RmLabel - Remove Label Uti1ity\n" 

"Copyright (c) Smuth Nakpansua, 1992, 1993. 


"Copyright (c) Smuth Nakpansua, 1992, 1993. 

All rights reserved\n\n") ; 


All rights reserved\n\n") ; 

if (argc != 3) { 


if (argc ! = 2) { 

printf("usage: DSKLABEL <drive:> <string-label>\n") ; 


printf("usage: RMLABEL <drive:>\n") ; 

return(-l) ; 


return(-l); 

} /* if */ 


} /* if */ 

drive = *argv[l] ; 


drive = *argv[l] ; 

drive |» ('A 1 <= drive && drive <= 1 Z') ? 0x20 : 0; 


drive |= ('A 1 <= drive && drive <= 'Z') ? 0x20 : 0; 

drive -= ('a' - 1); 


dri ve -= (' a ' - 1) ; 

if (strcmp(argv[l]+l, ":") != 0) ( 


if (strcmp(argv[l]+l, “:") != 0) ( 

printf("invalid drive: %s\n", argv[1]); 


printf("invalid drive: %s\n", argv[l]); 

return(-l); 


return(-l); 

} /* if */ 


} /* if */ 

if ( DosSetVolumeLabel(drive, argv[2])) 


if ( DosRemoveVolumeLabel(drive)) 

printf("Could not set volume label\n"); 


printf("Could not remove volume label\n"); 

return(0); 


return(0); 

} /* eof: main() */ 


} /* eof: main() */ 

/* End of File */ 


/* End of File */ 
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Listing 5 whello.c 


/* 

* whello.c 

* 

* James K. Lawless 

* 1622 Ave F 

* Council Bluffs, IA 51501 

* 

* This code is in reference to Steve Spector's 

* Tech Tip in the May 1993 issue of Windows/ 

* DOS Developer's Journal. 

* 

* Compile (Microsoft C): 

* nmake whello.mak 
*/ 

linclude <windows.h> 

LONG FAR PASCAL WndProc(HWND.WORD.WPARAM,LPARAM); 

HWND _hMainWnd; 

int PASCAL WinMain(HINSTANCE hlnstance, 

HINSTANCE hPrevInstance, 

LPSTR 1pszCmdParam, int nCmdShow) 

{ 

LPSTR lpszClass=“HelloWin w/Return"; 

MSG msg; 

WNDCLASS wndclass; 

if(hPrevInstance) { 

HWND hWnd; 

if(GetInstanceData(hPrevInstance, 

(BYTE NEAR *)(&_hMainWnd).sizeof(HWND))==sizeof(HWND))( 

if(Is Iconic(hWnd=GetLastActivePopup(_hMai nWnd))) 
ShowWindow(hWnd,SW_RESTORE); 

SetActiveWindow(hWnd); 


) 

return(0); 


wndclass.style 
wndclass.lpfnWndProc 
wndclass.cbClsExtra 
wndclass.cbWndExtra 
wndclass.hlnstance 
wndclass.hlcon 


= CS_HREDRAW | CS_VREDRAW; 
= (WNDPROC)WndProc; 

= 0 ; 

= hlnstance; 

■ LoadIcon(NULL, 

IDI APPLICATION); 


wndclass.hCursor = LoadCursor(NULL,IDC_ARROW); 
wndclass.hbrBackground= GetStockObject(WHITE_BRUSH); 
wndclass.IpszMenuName = NULL; 
wndclass.lpszClassName=lpszClass; 


RegisterClass(&wndclass); 

_hMainWnd=CreateWindow(lpszClass, 

IpszClass, 

WS_OVERLAPPEDWINDOW | WS_VISIBLE, 

0 , 0 , 200 , 200 , 

NULL, 

NULL, 

hlnstance, 

NULL); 


ShowWindow(_hMainWnd,nCmdShow); 
UpdateWindow(_hMainWnd); 

while(GetMessage(&msg,NULL,0,0)) { 
TranslateMessage(&msg); 


DispatchMessage(&msg); 

) 

return(msg.wParam); 


LONG FAR PASCAL WndProc(HWND hWnd, WORD message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hDC; 

PAINTSTRUCT ps; 

RECT rect; 

switch(message) ( 
case WM_PAINT: 

hDC=BeginPaint(hWnd,8.ps); 
GetClientRect(hWnd,&rect); 

DrawText(hDC,"Hel1o, Windows!",-1,&rect, 
DTSINGLELINE|DTCENTER|DTVCENTER); 
EndPaint(hWnd,&ps); 
return(O); 

case WM_DESTROY: 

PostQuitMessage(O); 
return(0); 

} 

return(DefWindowProc(hWnd,message,wParam,1Param)); 


/* End of File */ 


Xo claim the territory, 
have a 


(Rapture international markets by making your 
software easy to localize! Let InternaX videotapes, 
with Windows and Windows NT expert Dr. William 
Hall, show you how to design or retrofit your soft¬ 
ware for global success! 

For details, phone or fax 

(408) 438-2270 

InternaX 

6 Johnston Way, Scotts Valley, CA 95066 

Windows™ is ;i registered trademark of Microsoft Corporation 
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Listing 6 

whello.def 

NAME 

WHELLO 

DESCRIPTION 

'Hello program with auto-detection of multiplex 
instances 1 

EXETYPE 

WINDOWS 

STUB 

'WINSTUB.EXE' 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

8192 

EXPORTS 

WndProc 


Listing 7 whello.mak 


# Visual C++ (Microsoft C 8.0) NMAKE file 

whello.exe : whello.obj whello.def 
link /align:16 

/nod whello.whello.exe,NUL,slibcew libw.whello 
rc whello.exe 


whello.obj : whello.c 

cl /c /Zp /ASw /Gsw /Ow /W2 whello.c 
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Listing 8 vformat.c 


/* 

* vformat.c: 

* Illustrates John N. Power's technique of passing 

* variable format strings and variable data-type 

* parameters in printf() calls. 

* 

* Compile & Link (Borland C): 

* bcc vformat.c 
*/ 

linclude "stdio.h" 

#define REAL 0 

Idefine INTEGER 1 

#define ERROR 2 

char *fi 11 [] = {" 

II II \ . 


union number ( 

double real; /* <- Must use a double, not a */ 

int fix; /* float, since printf */ 

) sample; /* expects floats to be */ 

/* promoted when passed. */ 
void outnum(int type, union number *parm); 

main() 

( 

int i; 

for(i=l;i<ll;i++){ 
sample.fix = i; 
outnum(INTEGER, &sample); 
printf(*(fil 1 + ((i % 3) »* 0))); 
sample.real = sample.fix; 

/* <- implied type conversion */ 
outnum(REAL, Ssample); 

) 

return 0; 


char ‘format[] = { "%5.2f\n\ 

"%5d", 

'“ERR*" }; 

void outnum(int type, union number *parm) 

( 

if ((type != REAL) && (type ! = INTEGER)) 
type = ERROR; 

printf(‘(format + type), *parm); 

/* Pass the entire union by value. Let printf figure 
out how much of it to use. This union must be the 
last variable passed to printf, since printf 
determines the locations of its parameters from the 
lengths of the parameters, as indicated by the 
fields in the format string. Since not all of the 
all of the union may be used, placing the union 
anywhere but at the end will cause printf to 
mislocate the following variables. */ 


/* End of File */ 
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New Products 

Industry-Related News & Announcements 


Rogue Wave Announces SQL/ISAM Classes 


DB.h++ is a portable collection of C++ classes that 
provides object-oriented access to SQL and ISAM databases. 
The objects in DB.h++ include columns, rows, tables, and cur¬ 
sors. The product provides classes and methods to perform 
database operations ranging from executing SQL SELECT 
statements to altering column definitions and granting 
database privileges. It also comes with objects to manage 
complex data types stored as Binary Large OBjects (BLOBs). 


The DB.h++ classes are the same for both ISAM file 
managers and SQL databases, and applications written for 
ISAM are upwardly compatible with SQL. DB.h++ works with 
the leading databases and C++ compilers, including Microsoft 
C++, Borland C++, and cfront-based UNIX C++ compilers. 

DB.h++ for DOS costs $499, or $1,999 with source code. 
For more information contact Rogue Wave Software, Inc., 
P.O. Box 2328, Corvallis, OR 97339, (800) 487-32 17 or (503) 
754-3010 ; FAX (503) 757-6650. 


New DOS/16M Brings DLLs to DOS 

Rational Systems has upgraded its 16-bit DOS extender, 
releasing DOS/16M v5.0. The new version now supports 
Microsoft C/C++ v7.0 and Visual C++, as well as Borland C++ 
v3.1. The new version also works with CodeView and Turbo 
Debugger. DOS/16M v5.0 supports segmented executables 
and DLLs. At runtime, when your application calls code lo¬ 
cated in a DLL, D0S/16M dynamically loads the required code 


into memory and continues execution. You can use this ver¬ 
sion to create TSRs with only a 16Kb footprint in convention¬ 
al memory. 

D0S/16M v5.0 prices start at $5,000. For more informa¬ 
tion, contact Rationed Systems, Jnc., 220 No. Main St., 
Natick, MA 01760, (508) 653-6006; FAX (508) 655-2753. 


New Library Adds Exception Handling to C 


Exceptions for C is a new library that provides Ada-style 
exception handling for any ANSI-compliant C compiler. To 
use the library, you include xcept.h in your code and link 
with xcept.c. You can then declare blocks of code within 
functions that can catch and handle specific exceptions that 
might arise in the code block (or in functions called by the 
code block). Within code that detects an error, you can call a 


supplied function to raise an exception. The library then un¬ 
winds the stack, searching for the first function that has 
declared a handler for the exception that was raised. 

Exceptions for C costs $29.95 and includes complete 
source code. For more information, contact Koyn Software, 
1754 Sprucedale, St. Louis, MO 63146, (314) 878-9125. 


TestPro Moves to Windows 

Sterling TestPro for Windows is an integrated environ¬ 
ment for testing GUI applications. Automatic GUI testing re¬ 
quires attention to the interactive nature of Windows 
programs, including problems caused by multitasking and 
message passing. Menu-oriented programs that allow users 
to execute commands in any order require more thorough 
testing than traditional command-line programs. The 
product provides facilities for creating test sets, for managing 


tests, for running tests in a variety of modes, capturing and 
automatically analyzing test results, and for doing perfor¬ 
mance evaluations and generating reports. 

Sterling TestPro for Windows prices start at $2,500. For 
more information, contact Sterling Software, Dylakor 
Division, 9340 Owensmouth Avenue, Chatsworth, CA 
91313, (818) 718-8877; FAX (818) 998-2171. 
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Phar Lap Updates 386 1 DOS-Extender 

Phar Lap has released version 5.0 of its 3861 DOS-Ex¬ 
tender. The product turns DOS into a 32-bit operating en¬ 
vironment with a flat memory address space. Programs can 
access all available memory, up to four gigabytes. 3861 DOS- 
Extender supports XMS, VCPI, and DPMI memory specifica¬ 
tions, so programs developed with the product can run 
under DESQview, OS/2 v2.0, and all modes of Windows, as 
well as DOS. 

The new version lets developers use the Microsoft Win¬ 
dows NT 32-bit C++ compiler to develop 32-bit extended-DOS 
applications. The new extender supports the 32-bit Microsoft 


Just Logic Supports Relational Integrity 

Just Logic Technologies, Inc. has released a new version 
of its relational database for DOS and Windows programmers 
who use C and C++. The system can now contain program¬ 
mer-defined C++ objects within tables, and the database can 
be linked with the programmer’s own methods. The system 
comes with a database engine that includes a cost-based 
query optimizer. The new release supports relational in¬ 
tegrity and contains a rule system where actions can be trig- 


compiler under DOS and still provides the functionality of the 
16-bit Microsoft C++ DOS runtime libraries, including graphics. 
All of the standard 16-bit calls now work under 32-bit Ex¬ 
tended-DOS. The package includes 386|SRCBug, a 32-bit 
source code debugger, and the documentation has been 
revised and updated. 

The 3861 DOS-Extender SDK v5.0 costs $495. For more in¬ 
formation, contact Phar Lap Software, Inc., 60 Aberdeen 
Avenue, Cambridge, MA 02138, (617) 661-1510; FAX (617) 
876-2972. 


gered by database events. Programmers can choose among 
three interfaces: a C API, a C++ class, and a C precompiler. 

The Just Logic Database costs $395 for a single-user ver¬ 
sion with no runtime royalties. The product is compatible 
with Microsoft C/C++ (v7.0 and later) and Borland C++ v3.1. 

For more information, contact Just Logic Technologies, 5070 
Santa Fe Street, San Diego, CA 92109-1633, (800) 424- 
2534; FAX (619) 490-9232. 


Image Library Supports More Formats 

The AccuSoft Image Format Library is a DOS library and 
Windows DLL that provides access to standard raster file for¬ 
mats. Using the library, your application can read and write 
image files and convert from any format to another. The 
library includes display functions that permit zoom, pan, and 
scroll, and also offers printing. Image processing functions in¬ 
clude rotate, resize, invert, flip, contrast and brightness con¬ 
trol. The library also offers color conversion functions for 
reducing image depths, supporting 24-bit to 8-bit, color to 
gray, color to black-and-white, and color to half-tone. 

The new release adds support for PICT, JPEG, and EPS read 
and write. The new version also offers faster GROUP III and 
Group IV decompression, easier to use low-level functions, 


faster printing, faster Group IV compression, and faster dis¬ 
play functions for DOS and Windows. The company guaran¬ 
tees the library will read the raster images from any file in 
the supported formats (TIFF v6.0, PCX, DCX, TARGA, GIF, DIB, 
WMF, BMP, WPG, EPS, PICT, and JPEG) regardless of the flavor 
or type of compression used. 

The AccuSoft Image Format Library v3.0 costs $495 for a 
single workstation license for DOS and Windows. Watcom 
and High C 32-bit versions, as well as source code, are avail¬ 
able separately. There are no royalties or distribution fees. 
For more information, contact AccuSoft Corporation, 160 E. 
Main SL, P.O. Box 1261, Westborough, MA 01581, (508) 
898-2770; FAX (508) 898-9662. 


Segue Announces Cross-GUI Test Tool 

QA Partner is a new cross-platform, object-oriented GUI 
test automation system from Segue Software. QA Partner is 
available on Microsoft Windows, the Macintosh, and 
UNIX/Motif platforms. Single-user licenses cost $1,495 for 


Windows or the Macintosh, and $4,995 for the Motif version. 
For more information, contact Segue Software, Inc., 1320 
Centre Street, Newton Centre, MA 02159, (617) 969-3771; 
FAX (617) 969-4326. 


Gnu EMACS Moves to Windows 3.1 

Pearl Software has ported Gnu Emacs to Windows 3.1. 
Gnu Emacs is a large, feature-laden editor popular on UNIX. 
The editor offers the Emacs Lisp Extension language; hyper¬ 
text help and an online manual; line, block, and character 
marks; full undo and redo; multiple editing buffers; regular 
expression search and replace; incremental search; proce¬ 
dure tagging with completion for C, C++, Pascal, and other 
languages; syntax expansion and indenting; begin/end struc¬ 
ture and brace matching; word wrap and full justification; 
configurable key bindings; a mode line; and a large library of 
Emacs Lisp for other extensions. 


The Pearl Software port also provides Windows-specific 
features, including a menu and drop-down menu bar, sup¬ 
port for multiple fonts and typefaces, cut-and-paste mouse 
support, clipboard support, and DDE and OLE compatibility. 

Pearl Software charges $49 to ship the shareware version 
of the product, or $199 fora registered version with techni¬ 
cal support. For more information, contact Pearl Software, 
320 Lenox Ave., Oakland, CA 94610, (510) 273-9795; FAX 
(510)839-9820. 
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Updated PROLOG Offers Better Windows Support 


Logic Programming Associates Ltd. has updated its Win¬ 
dows software tools for 80386/80486 machines. The Win¬ 
dows series consists of LPA 386-PROLOG for Windows, 
flex/386 for Windows, and Prolog++/386 for Windows. This 
new release, version 2.0, includes direct access to Windows 
dialog, font, window, and menu facilities from within the 
compiler package, increased performance, enhanced support 
for Windows 3.1, and a configurable source-level debugger. 

The development environment offers a SAA-compliant, 
mouse-driven user interface that lets you edit, compile, and 
debug programs. All products in the series use incremental 
compilation, combining the execution speed of a compiler 
with the interactive nature of an interpreter. Products in the 
Windows series are available in two editions. Programmer 


Editions include all the built-in predicates, development en¬ 
vironment, debugger and documentation, and an interface 
to DLLs written in C, C++, or Pascal. Developer Editions also in¬ 
clude a runtime generator for producing standalone applica¬ 
tions. 

LPA 386-PRLOG for Windows costs $745 for the Program¬ 
mer Edition, or $1,495 for the Developer Edition. All these 
products require an 80386/80486 machine with at least 4Mb 
of memory and Windows 3.1. For more information, contact 

Logic Programming Associates Ltd, Studio 4, Royal Vic¬ 
toria Patriotic Building, Trinity Road, London, SW18 3SX 
England, 081 871 2016; FAX 081 874 0449; lpa@cix.com- 
pulink.co.uk; AppleLink: UK0049. 


Lifeboat Releases Charting DLL 

Essential Graphics Chart for Windows is a new 
developer's tool that lets you add professional charts to your 
Windows application. The library is a DLL that can display 
multiple charts in multiple windows simultaneously. You can 
access the library from any language that can call DLL func¬ 
tions (C, C++, Visual Basic, Borland Pascal, etc.). An interactive 
CASE tool lets you design and prototype charts. 

Chart types supported include 2-D and 3-D bar and pie, 
line and scatter, high-low-close, real-time, area, pyramid, and 


others. The library supplies default information for all chart 
settings, allowing developers to display data in only a few 
function calls. You can control aspects of chart presentation 
that include titles, colors, labels, fonts, and legends. Printing 
is handled through a virtual bitmap driver. 

Essential Graphics Chart for Windows costs $399, and 
there are no royalties or runtime fees. For more information, 
contact Lifeboat Software, Voyager Software Corp., 1163 
Shrewsbury Avenue, Shrewsbury, N] 07702, (908) 389-8950. 


RUNOS2 Creates Dual-Mode Executables 

FlashTek is adding a new feature to their X-32VM DOS ex¬ 
tender. The new feature, ailed RUNOS2, lets developers con¬ 
vert certain 32-bit OS/2 2.0 applications into self-contained, 
dual-mode executables that can run under OS/2 2.0 or DOS. 

For DOS a special stub contains a DOS extender that executes 
under DOS and provides a subset of the OS/2 API. This 
enables it to load and execute a text-mode OS/2 executable, 
supporting up to 3.5 gigabytes of virtual memory and 80387 
emulation for floating-point applications. It also supports all 


DOS extended memory allocation standards, including DPMI, 
VCPI, XMS, and INT 15h. RUNOS2 supports about 50 OS/2 func¬ 
tions, including all ANSI and POSIX 1003.1 functions provided 
in the runtime libraries of the supported compilers (Borland 
and Watcom). 

X-32VM with the RUNOS2 enhancement costs $250. For 
more information, contact FlashTek, Inc., 121 Sweet Ave., 
Moscow, ID 83843, (208) 882-6893; FAX (208) 882-7275. 


Desaware Enhances Custom Control Factory 


Custom Control Factory is a tool for creating a wide 
variety of button and image style controls for Visual Basic ap¬ 
plications. The tool was designed to bridge the gap between 
the standard controls included with Visual Basic and custom 
controls, which require advanced programming with the 
Visual Basic Control Development Kit You can create Custom 
Control Factory buttons interactively from within the Visual 
Basic design environment without special programming. The 
tool lets you create animated buttons, multistate buttons, 
toolbars, and enhanced button, checkbox, and option but¬ 
tons. 

Version 2.0 of the tool offers new features, including: 
multiline captions with flexible alignment; automatic 3-D bor¬ 
ders with user-defined colors and border bevel widths; 256- 


color support; image compression; custom cycle/drawing 
capabilities; improved synchronization events during anima¬ 
tion; improved metafile support, including flexible position¬ 
ing and sizing; DDE support; the ability to load cursors for 
improved compatibility with CCF-Cursors; a new frame align¬ 
ment dialog box that makes it easy to align frames and 
match their sizes; improved performance and efficiency. The 
Custom Control Factory also includes a new listbox control 
that holds bitmaps as well as text, and allows you to color 
each entry in the listbox independently. 

Custom Control Factory v2.0 costs $48 plus shipping and 
handling. For more information, contact Desoware, 5 Town 
& Country Village #790, San Jose, CA 95128, (408) 377- 
4770; FAX (408) 371-3530. 
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XVT Announces C++ Application Framework 


XVT Software Inc has released XVT-Design++ Release 
1.0, a new software package that provides a complete GUI 
tool for creating C++ applications. The package includes an in¬ 
teractive design tool for user interfaces that incorporates a 
C++ code fragment editor, and a C++ application framework 
that includes GUI objects. The new product works with the 
XVT Portability Toolkit, which offers application portability 


across Windows, Windows NT, the Macintosh, OS/2 Presenta¬ 
tion Manager, Motif, and other platforms. 

XVT-Design++ costs 51,395 for Intel 80486 systems and 
$3,095 on workstations such as Sun Microsystem's. For more 
information, contact XVT Software Inc., 4900 Pearl East 
circle, Box 18750, Boulder, CO 80308, (303) 443-4223; FAX 
(3 03) 443-0969. 


Logan Releases FAX Library 

Direct-FAX API is a new library of FAX support functions 
for C programmers, from Logan Industries, Inc. Developers 
can use Direct-FAX to add FAX support from their C applica¬ 
tions; sending a FAX can be as easy as performing a single 
function call. 

Direct-FAX provides a set of over 40 functions to manage 
most FAX-related tasks. The library supports FAX transmis¬ 
sion of ASCII text and PCX or DCX graphic file formats, and of¬ 
fers group transmissions, scheduling FAX transmissions, and 


polling remote FAX machines. The Direct-Fax library is 
designed to work with CAS-compatible FAX modems and is 
compatible with Borland and Microsoft C compilers. The pack¬ 
age also supports Windows as well as DOS applications. 

The Direct-Fax library costs $129, or $199 with source 
code. For more information, contact Logan Industries, Inc., 
604 Mango Drive, Melbourne Beach, FL 32951, (407) 984- 
1627; FAX (407) 951-7292. 


Netmagic Offers 3-D Graphs for XVT 

Netmagic Systems, Inc. has announced GRAPHMAGIC, an 
interface that lets you quickly add 2-D and 3-D graphs to 
XVT applications. GRAPHMAGIC requires a single API call to 
create standard bar charts, pie charts, area charts, and scat¬ 
ter charts, in 2-D and 3-D. You can customize aspects of the 
chart appearance, including chart item color, brush types, 
legend font, and background color. The library supports an 
unlimited number of charts per window and can update a 
displayed chart without having to redraw the entire chart. 


GRAPHMAGIC is available for Windows, Presentation 
Manager, Motif, Open Look, and all other XVT platforms. 
GRAPHMAGIC for Windows 3.x, Windows NT, and Presenta¬ 
tion Manager costs $495; for all other graphical platforms, 
$995. Source code is available at $6,995 per site. For more in¬ 
formation, contact Netmagic Systems, Inc., 2393 Maple 
Avenue, Peekskill, NY 10566, (914) 739-4579; FAX (914) 
739-4616. 


TSX-32 Adds NFS Client/server Networking 


TSX-32 is a 32-bit, multi-user, networking operating sys¬ 
tem compatible with DOS and Windows. TSX-32 is currently 
available for IBM PCs, PS/2s, and compatible computers 
based on 80386, 80486, and Pentium processors. The new 
version provides NFS client/server networking, built-in peer- 
to-peer TCP/IP-based networking and X-Windows GUI. TSX- 
32 systems can interoperate with UNIX systems, Netware 
LANs, mainframes, minis, Macintoshes, and others. 

TSX-32 v4.0 also provides a new disk shadowing facility. 
You can configure the system to shadow entire disks, a set 


of directories, or individual files, and you can shadow them 
on local drives or across the network to remote systems. 

The new version also supports the DPMI standard with 
Microsoft's extension, offering compatibility for more Win¬ 
dows and DOS programs. 

TSX-32 v4.0 license fees range from $450 to $2,500 for 
single-user, multi-user, and LAN licenses. For more informa¬ 
tion, contact S&H Computer Systems, Inc., 1027 17th Ave. 
South, Nashville, TN 37212, (615) 327-3670; FAX (615) 321- 
5929. 


CC-RIDER Moves to Windows 

CC-RIDER is a C and C++ source code analysis and brows¬ 
ing package available for DOS, OS/2, and now Windows. The 
new Windows source code browser links with any Windows- 
based editor to provide source code navigation in your own 
editing and debugging environment The C++ analyzer takes 
advantage of Windows multitasking to provide background 
analysis, as well as using extended memory to cache 
database I/O for better performance. Other new features in¬ 
clude class hierarchy charts, function call tree diagrams, 
printed graphic reports, a complete API library for accessing 
the source code database from your own DOS or Windows 


program, full ASCII symbol listings, automatic documentation 
taken from source code comments, a flat-file database ex¬ 
port utility, and QuickHelp database output. 

CC-RIDER v4.0 for Windows supports all proposed ANSI 
C++ features, including nested classes, templates, and excep¬ 
tion handling, with specific language feature support for cur¬ 
rent versions of Borland, Microsoft, and Zortech C/C++ 
compilers. The full professional version, which now includes 
Windows support, retails for $279. For more information, con¬ 
tact Western Wares, P.O. Box C, Norwood, CO 81423, (303) 
327-4898. 
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Readers' Forum 


Ron, 

This is a quick note to let you know, 
if you don't already, that Paul 
Bonneau's article in the June issue of 
Windows/DOS Developer's Journal has an 
embarrassing error — basically the code 
works exactly opposite as intended. 
(This is from reading the code. I’ve not 
run the example.) 

The PeekMessage () call in the right¬ 
most column on page 77 is: 

PeekMessage (&msg, NULL, 0, 0, 
PM_N0REM0VE) ; 

It should be, according to the text in 
the article: 

PeekMessage (&msg, NULL, WMJJSER, 
WMJJSER, PM_NOREMOVE) ; 

Brent Rector 

You are exactly right. I compiled 
and ran the code with three different 
compilers and I'm very disappointed 
that I still failed to notice the semantic 
error. “Embarrassing error" hits the nail 
right on the head. 

For the benefit of readers who may 
not know Brent, besides occasionally 
giving us a free code review, he is the 
author of the book Developing Win¬ 
dows 3.1 Applications with Microsoft 
C/C++, which is in my view the only 
Windows programming book that com¬ 
petes with Petzold in breadth and 
depth of coverage. Check it out. —rib 


Ron, 

This is in reply to your lead editorial 
in the May 1993 issue of Windows/DOS 
Developer's Journal, wherein you refer 
to "a great [hack] from Microsoft" 
described in a sidebar in Paula 
Tomlinson's NT device driver article. In 
that sidebar, on page 22, Paula 
describes how Gates' gang defined 
macros to generate illegal x86 instruc¬ 
tions which cause the hardware to trap 
into the VDM's exception handler. It 
tests for the 58H code in the byte just 


past the offending instruction, and on 
finding that, interprets the next byte as 
a request from a 16-bit application 
being smuggled through the VDM 
emulator to the 32-bit VDD. 

This piece of cleverness was in¬ 
vented by someone within IBM roughly 
30 (yes, thirty) years ago. The Sys¬ 
tem/360 architecture was at that time 
novel by virtue of being emulated on a 
variety of different underlying hardware 
platforms engineered to hit various 
points on the price/ performance curve. 
In order to allow field engineers to run 
hardware-specific diagnostics em¬ 
bedded in a portable 360-code shell, 
IBM designed into their programmer’s 
view of the 360 a "Diagnose" instruc¬ 
tion, which was privileged and machine- 
dependent. It was a way for a stand¬ 
alone utility (which naturally ran in "su¬ 
pervisor”, i.e. privileged state) to smug¬ 
gle requests through the 360 emulator 
to exercise the real hardware under¬ 
neath. 

Then, along came VM/360, which 
emulated multiple virtual 360-architec¬ 
ture machines on one physical 360, and 
which was coded using the "portable” 
360 instruction set rather than in the 
physical instruction set of any specific 
model. (VM/360 has since evolved 
through VM/370 into the VM/CMS sys¬ 
tem which would be IBM's answer to 
UNIX were it only open ... but that's a 
different editorial!) Since Diagnose was 
a privileged instruction, and virtual 360s 
always ran in "problem," i.e., non- 
privileged state, it would cause the 
hardware to trap into the exception 
handler of the VM CP (Control Program) 
whenever it was issued by a program, 
even an operating system, running in a 
virtual machine. 

VM began as laboratory too! for 
prototyping changes in the instruction 
set. In order to transform it into a prac¬ 
tical time-sharing system which would 
run its older, batch OSs as guests (for 
good old backward compatibility), IBM 
had to deal with performance issues. 


Guest systems could save a lot of over¬ 
head if they could determine whether 
they were running under VM (rather 
than on the bare hardware), and if so, 
issue "hypervisor calls” to get really 
hard work done at the VM/CP level. The 
determination was based on the result 
of "store CPU id”, another privileged in¬ 
struction which VM/CP deliberately 
tagged in a way that no model’s 
microcode ever would. The hypervisor 
calls were all based on Diagnose, just 
the same way that RegisterModule, 
UnRegisterModule, and DispatchCall 
are all based on “LES AX,SP”. 

Just to complete the analogy, IBM's 
assembly language did not provide any 
mnemonic op code for Diagnose, for 
much the same reasons that no well- 
behaved Intel x86 assembler would let 
a "LES AX,SP” instruction slip by. Hyper¬ 
visor calls are supported by assembly- 
language macros, which expand into 
hex constants (for the operation code and 
register operands) and normal address 
constants for the parameter list, if any. 

So, I agree with you that it’s a great 
hack. It's still in use today in thousands 
of VM/CMS shops around the world. 

Regards, 

H.E. (Ted) Syrett 
CONNECT, Inc. 

Internet: HESYRETT@connectinc.com 

P.S. Thanks to Paula for a most infor¬ 
mative and well-written article, and to 
you for publishing it. 


Dear Ron, 

In the May 1993 issue of Win¬ 
dows/DOS Developer's Journal you men¬ 
tion in your editorial Microsoft’s hack as 
described in the sidebar “The VDD Back¬ 
door,” on page 22. 

You might be interested to know 
the same technique has been used for 
over 20 years in IBM’s VM operating 
system, where a nonexistent instruction 
(DIAGNOSE) is used to force an exception 
within a virtual machine which is then in¬ 
terpreted by the VM kernel as a request 


July 1993 


Windows/DOS Developer’s Journal — Page 99 
































for services. The similarity is even more 
marked when we look at a sample se¬ 
quence of data bytes associated with 
the DIAGNOSE pseudo-instruction: 

db 83h, 54h, 0, 58h 

This is the sequence of four bytes that 
is required to send a formatted 
datastream to the terminal. The DIAG¬ 
NOSE function 58h is often used under 
VM by programs that want to work 
with text-mode windows, which makes 
it interesting to note that the same hex 
value of 58h is also used in Win¬ 
dows/NT! Perhaps someone on the 
Windows/NT team is an old IBM VM 
systems programmer! 


Best Regards, 

Andrew P. Biss 
IBSI CASE Development GmbH 
Novesiastrasse 38 
D-4044 Kaarst 2 (Dusseldorf) 
Germany 

Thanks to both Ted and Andrew for 
the fascinating historical perspective. It 
just goes to show there’s not much 
truly new and original in the software 
business, just endless variations on 
past themes, —rib 


Fm: Nico Mak [70056,241] 

Once again I found an interesting ar¬ 
ticle in the latest Windows/DOS 


Developer's Journal, logged on to 
CompuServe to download it, and was 
disappointed that the code hadn't been 
posted yet. I'm sure other readers have 
the same experience. So, I’m writing to 
encourage you to regularly post the 
code before readers get the magazine. 
To conclude on a more positive note, it 
is a very useful magazine (if the articles 
weren't interesting I wouldn't have this 
problem!). 

Nico Mak 

VJe are continuing to work on an 
improved process for constructing and 
distributing our code. Due to letters 
like yours, it is now our goal to get the 
code on CompuServe by the day the 
magazine is mailed from the publisher. 
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PM 
Mac 
Oracle 
Progress 
Windows NT 
Smalltalk 
Case 
OS/2 

Our midwest Clients are using 
Leading edge technology you thought 
you'd only see on the coasts. Discover the 
heartland, our quality of life and our 
commitment to technology. 

Employer Paid fees only. 

All recruiters are certified by the NAPC. 

Brad Moore, C.P.C. 

256 N. 115th Street, Suite 1, Omaha, NE 68154-2521 
(402) 334-7255 Fax (402) 334-7148 
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The programming 
solution for TCP/IP 
under Windows! 


Encapsulates TCP/UDP/TELNET & TFTP 
in a robust and easy-to-use server, so you 
don’t write socket library code! 


Genisys Comm Pack++ 


SDK provides 3 functions for C/C++/Pascal, 
Visual Basic Custom Controls too! 

^ For OLTP, emulators, all client/server apps, 
PC to UNIX and PC to PC connectivity 
$50 embedded stack option for integrators! 


To download the GCP++ Evaluation Kit, contact: 



.RKOfT- 



Genisys Comm, Inc. 

314 South Jay St., Rome, NY 13440 

(315)339-5502 

GCP++@GF.NISYS.com 
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Career Marketing Associates 

7100 East Belleview Avenue. Suite 102 
Englewood. CO 80111_ 

Today, 1993 

Dear MS WINDOWS DEVELOPER: 

You’re talented. You know your 
C++ and API calls and all the 
alphabet buzzwords. But does your 
boss understand and appreciate you? 
I don’t think so. He thinks OLE is 
bullfighter talk. 

So teach them a lesson and take 
your services elsewhere. Maybe you 
should contact a professional 
recruiter. I would suggest Career 
Marketing Associates in Colorado. 
Why? With 280 affiliates all over the 
country, we might come across the 
perfect opportunity for you. So write, 
fax, call, or co mm unicate in your 
dreams with us. We want to hear 
from you. y 


Sincerely, 



Gary Patton 
303-779-8890 
FAX 303-779-8139 


( ; \ 

Windows 

Developer Jobs 


Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 
Mac, CASE, Video, Realtime. 
Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1 - 800 - 231-5920 



Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SPI-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 926-6188 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
T^ompuserve: 71250,3001; Genie: D.SMALL6 ^ 
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Hot Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audio tex 
Applications 


1. Create fantastic prompts 
and save time with VFEdit ®! 
Record, crop, cut, copy, 
paste, mix, fade, echo, 
volume & more with your 
Dialogic™ D4x/12x boards. 

2. Add Voice Mail power 
to your MS Windows apps 
with TI/FDLL™, our Tel 
I/F Dynamic Link Library. 

3. Audio Tool Box™ 
converts to and from 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 
& 8 at any sample rate! 

4. Scribe Transcription 
Utility for DOS plays digital 
audio Files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
VoxFonts™, our "software 
only" text-to-speech library! 


Order Now: 1-800-234-V/SI 


[ Voice Information Systems: 24 N Merion Ave, Bryn Mawr, Pa 190101 
Tel: 215-747-5035/ BBS: 215-747-5062/ Fax: 1-800-234-FXIT 
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Use all 
of your 
senses! 

add multimedia to your 
Windows projects 
The Sound Clip Collection 


WW2 

Bagpipes 

Animals 

Voyager 

LA Riot 

Subway 

Indians 

Drains 

Spacemen 

Kids 

Cars 

...and much, 

Volcano 

Quakes 

much more 


PC speaker driver included! 

Only $34.95 NEW ART INC. 

(NYS residents 200 W. 79 Street 

add tax, Windows Suite 8H 

3 .1 required) NYC, NY 10024 

_ We hsf/ePhqto^Clip artJoo[ _ 
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SYInstal 


Version 2.0 




Installs anything... 

You just run the install builder, telling it your 
company name, application name, default 
directory, disk space required and list of files. 

No programming or scripts to write. 

What SVInstal does... 

♦ Creates destination directories, copies files. 

♦ Makes program group, puts in your icons. 

Features... 

Progress gauges, multiple source disks, directory 
trees, file compression, network server/client or 
standalone. No royalties! 


Soft Ventures (dept. wdj> 

Box 22183 Bankers Hall 

Calgary Alberta Canada ' (plus $5.00 s&h) 

T2P4J5 (403)278-1681 Canadian $69.95 + 7% GST 


$59.95us 
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Full 

money-back 
guarantee. 

CICA MS WINDOWS CDROM $24.95* 

Thousands of MS Windows programs. Utilities, 
games, source code, programming tools, fonts, tech 
documents. Made in April 1993. 

Giga Games CDROM $39.95* 

Thousands of games for MSDOS and Microsoft 
Windows. Arcade games, word games, strategy 
games, lots of educational games. April 1993. 

Simtel MSDOS CDROM $24.95* 

640 megabytes, 9000+ files. Programming tools, 
dos utilities, tech docs, comm, bbs, education, much 
more. Made in May 1993. 

* Shareware programs require separate payment to 
authors if found useful. 


Walnut Creek CDROM 

4041 Pike Lane, Suite E 
Concord, CA 94520 USA 

1 -800-786-9907 +1 -510-674-0783 
VISA/MC/AE/COD +1-510-674-0821 FAX 
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Does your company provide 
tools, products, or services 
for advanced Windows 
programmers? 

Then reach over 27,000 
serious programmers in: 

Windows/DOS 

□ DEVELOPER'S JOURNAL 


Call 913-841-1631 today for 
information about advertising 
opportunities in Windows/DOS 
Developer’s Journal. 

Advanced. Serious. 
Technical. 

Brian Osborn • Continental Europe. 

Ed - East Donna • Midwest Edwin - West 
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RCS™ 4.2 PVCS ,M TUB™ 3.0 TUB™ 5.0 

Times are to update a 45K library on a PC/XT. PVCS and TLIB 3.0 are 
Irom Sept 87 PC Tech Journal. MKS RCS 4.2 and TLIB 5.0 are newer. 

TLIB™ is BEST 7 

"Do not he fooled by the fact that this is the 
least expensive of the fixe packages reviewed 
here - TLIB has features and power to spare" 
John Rex, Computer Language 
“TLIB is a great system" J. Vallino, PC Tech J 

. Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
merge parallel changes and undo intermediate 
revisions. Network and WORM support. Main¬ 
frame compatible deltas for Pansophic, ADR, IBM, 
etc.. Integrates with Opus “ MAKE & Slick™ MAKE. 

MS-DOS $139, OS/2 $195 + shipping visa/wc 
5 station LAN license $419 (OS/2 $595), call for other sizes 

BURTON SYSTEMS SOFTWARE 

PO Box 4156, Cary, NC 27519 (919) 233-8128 


SOFTWARE ENGINEERING POSITIONS 
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C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION ! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, ’C’ statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL : C-DOC ($199) All 5programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deterred reports. 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 
ONT, Canada Voice/Fax (4161-858-446 
L5N-4M1 Demos/BBS (41c 




see AD INDEX for our larger ad 


□ Request 103 on Reader Service Card □ 



We Understand The 
Programmer's Mind 

When the country's top firms look for the 
best developers available, they turn to 
Bateman. Why? Because we specialize in 
Microsoft Windows, NT, OS/2 and Macin¬ 
tosh recruiting nationwide. So if it's time for 
a career move, give us a call. We under¬ 
stand your skills, and the marketplace for 
them... we understand you. 

□Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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It will take a bit longer to accomplish 
that for some of our other distribution 
sites. The month after your note, we 
achieved that goal, so now all we have 
to do is keep it up. I should also men¬ 
tion to readers that we are now avail¬ 
able on GEnie. Thanks for prompting 
us to provide better service, —rib 


Fm: Dan 0. Butler 72134,633 

Hi, I'm a subscriber to Windows/DOS 
Developer’s Journal. I'm a developer who 
uses Borland Pascal to develop for Win¬ 
dows, and I would like to see more Pas¬ 
cal-based articles in the magazine. I 
have been using Turbo Pascal ever 


since version 2, way back in '84 (or 
thereabouts). I know some C and a little 
C++, but my favorite is Pascal. In par¬ 
ticular, I would like to see some 
reviews of different toolboxes, like 
those by TurboPower, Blaise, and Far- 
Point. Also database engines such as 
Paradox Engine, B-Tree Filer, Btrieve, etc. 
(I use B-Tree Filer.) 

Dan Butler 

A rule of thumb is that I would need 
to receive 5-10 Pascal article 
proposals to produce one magazine 
article. Unfortunately, I currently 
receive less than one Pascal proposal 
per month. Maybe your letter will 


stimulate some good submissions. My 
first priority is not product reviews, 
however, but short, focused articles 
about code that solves a specific 
problem. While I’m at it, where are all 
the Visual Basic proposals? I know 
there are many C/C++ programmers 
out there using Visual Basic for 
specific projects and solving problems 
with bits of nifty code that would be 
perfect for magazine articles. If it's too 
short for an article, submit it as a Tech 
Tip. Either way, you get paid, a mo¬ 
ment of fame, and a chance to make 
life easier for some of our other 
readers, —rib 
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The Art of Visual Basic Programming ™ 

This amazing new book by J. D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 
ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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DOS for $5.00!* 

We want you to select our new 
DOS/NT, a highly portable microkernel 
DOS compatable operating system that 
will make you take notice! So we’ll 
send you a shareware version for a 
$5.00 media charge. 

If you like it, we’ll send you a registered 
version and include a C compiler and 
Basic interpreter for a $20 registration 
fee. 

Call for source licensing! DOS/NT is 
already in sophisticated embedded 
avionics systems and running on 
MC68040 processors! 

Networks Software Systems, Inc. 
23 Cornwell Road 
Freehold, NJ 07728 
(908) 206-0320 VOICE 
(908) 303-9364 FAX 

*Plus $1.50 shipping Continental U.S. 

$3.00 others. 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only 4129 + $5 s&h ($15 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw a re 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 

□ Request 149 on Reader Service Card □ 
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COM1: - COM4: WITH WINDOWSI 

1,2, OR 4 PORT RS-232 BOARDS 
RS-232 AND RS-422 VERSIONS 
XT AND AT INTERRUPT JUMPERS 
OTHER PRODUCTS INCLUDING LAPTOP 
ADD-ONS 

DELIVERY FROM STOCK 
MADE IN USA 

EXCELLENT TECHNICAL SUPPORT 


5EALEVEL 


SEALEVEL SYSTEMS INC. 
POBOX830 
LIBERTY.SC 29057 

803 - 843-4343 
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Opt-Tech Sort/Merge 


^ New -Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 J 
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Macro 
Language 
"To Go" 


Easily add Netlogic’s full featured 
macro language facility to your 
Windows application -- at a fraction of 
the time and cost of developing it your¬ 
self. Seamless integration. Full basic 
syntax. Integrated editor and debug¬ 
ger. Extendable and modifiable. For 
more information: Netlogic Inc., 915 
Broadway, New York, NY 10010. 
Phone 800-638-0048. Fax 212-533-9524 

ProMacro ™ 

Your Application's Shortcut to Power 

□ Request 171 on Reader Service Card □ 


ABSOLUTELY, 
POSITIVELY, 
NO MORE 

Vls T iHO, 

ERrOR S / 


$5/disk, 

one issue per disk 
or ALL of 1992 
or 1991 for $20! 

Call today! 

913 - 841-1631 

FAX 913-841-2624 


WindowsyPOS 

□ DEVELOPER'S JOURNAL 

Suite 200 

1601 West 23rd Street 
Lawrence, KS 66046 


CD 


EACH TOPIC 
DISK 

CONTAINS 

HUNDREDS OF 
APPLICATIONS 

THOUSANDS 
OF FILES 

MANY WITH 
FULL SOURCE 
CODE. 


KNOWLEDGE MEDIA 

RESOURCE LIBRARY 


ROMs 

GRAPHICS 

ANIMATION, PAINT, CONVERTERS, 
fRACTAl, DRAWING, JPEG. 
MAPPING, GIF, PLOTTING, PAINT, 

AUDIO 

CONVERTERS, MttH EDITORS, 
MIXERS, MOOS^ MUSIC, PLAYS 
SNO, SrfSECH TfeAC. 


MULTIMEDIA 

AUTHORING SYSTEMS, PRESENTATION 
n/WEITS. CONTJNI MEDIA U8RARIES 


ORDER DESK: (800) 78 CD ROM 
ORDERS BY FAX (916) 872-3826 
VISA and MASTER CARD or COD 
436-B Nunneley, Paradise, CA 95969 
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SDLC, HDLC OR X.25 
SUPPORT ON THE PC 

Use the Sangoma SDLA card to 

provide exceptionally cost effective, full 

featured, stable and easy to use link 

support for your product or project. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Menu driven test program included 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation 

• High level interfaces for X.25 under 
DOS, UNIX, Windows, OS/2. 

Sdfl^O Ml <1 Technologies Inc. 
Tel: (416) 474-1990; (800) 388-2475 
FAX: (416) 474-9223 


A '^ CC-RIDER 

C for WINDOWS ) 

V_ _✓ 

SOURCE ANAL YSIS, DOCUMENT A TfON AND 
BROWSING FOR ANY EDITOR l 

NEW FEATURES INCLUDE: 

* Quick March of all symbol definitions and usages, even 
Inherited class members, macro expansions, etc. 

* Windows Interface source code browser with class 
hierarchy chart* and function call tree dtograms 

* Browsers link to any text-mode or Window* editor. 

* Print symbol cro*« reference, module summaries, function 
call trees, class hierarchy charts and more. 

* Database export to QuIckHelp. ASCII CSV (cBase). 

* API library lets you directly access the symbol database 
from your own C or C++ codel 

* PLUS ALL the classic CC-PIDER features to tockle those BIG 
unexplored programsl 


FULLY SUPPORTS CUSS NESTING, TEMPLATES, EXCEPTIONS, 

BOR UNO C++, ZORTECH C++, US C/C++ 7 * ALL ANSI C COMPILERS 

f WESTERN 
WARES 


For DOS, Windows and OS/2 ) 

(303) 327-4898 

( FREE DEMO DISK ^ 

; MONEY-BACK GUARANTEE 

[ Box C Norwood, CO 81423 

_> 
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WINDOWS* *SDK*GIS* 
MAC* DATABASE 
INTERNALS 

C, C++ /Windows/SDK/Visual 
Basic, Oracle, Sybase, progmrs 
needed. Positions available in 
Houston, Denver mid 
Pennsylvania, Upstate New York, 
Denver, Multiple platforms & 
languages welcome, especially 
MAC Sys 7 and/or C C++ UNIX X 
Windows exp. Call,fax Resume: 
to: 

THE HIGHLAND GROUP 
P.O. Box 5753113 
Houston, Texas 77257-3113 
713-953-1806 fx713-953-1820 
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Does your company provide 
tools, products, or services 
for advanced Windows 
programmers? 

Then reach over 27,000 
serious programmers in: 

Windows7POS 

□ DEVELOPER'S JOURNAL 

Call 913-841-1631 today for 
information about advertising 
opportunities in Windows/DOS 
Developer’s Journal. 

Advanced. Serious. 
Technical. 

Brian Osborn - Continental Europe. 

Ed - East Donna - Midwest Edwin • West 


Tools for Novell’s Btrieve- 

Bsupport III ltsupport II 

Bed it 3.0 • Btrieve file viewer/editor. 
Banalyze 2.0 • Btrieve app. debugger. 

Bran 2.2 - BUTIL replacement plus source, 
llcreate 2.0 - file creation utility. 

Bclieck 2.0 - Btrieve file analyzer. 

Xsupport 1.0 - build data dictionary 
(.DDF) for Access, OV, 
Crystal Rpts. 

Xport 2.0 - export/import CDF, SDF, 
dBASE. 

Call for information on additional 
products and FREE demo! 

Information Architects, Inc. p| l: (800) 359-2721 
3130 Pine Tree Road (517) 887-8000 

Lansing, MI 48911 Kax: (517) 887-2366 
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NEW v4.0 

links 50% faster and fully 
supports Turbo Debugger! 

SLR Systems, Inc. 

(412) 282-0864 . Fax: (412) 282-7965 
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Use this postage paid 
card to stay up-to-date 
on products 
that affect 
your productivity. 

Just fill out the card 
and drop it in the mail. 
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1) I program: 

□ for a living 
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□ MS-DOS □ Windows 

3) I program most frequently in 
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D Please start my subscription to 
Windows/DOS Developer’s Journal 
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countries). 
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Discover why FoxPro, Clipper, 
and dBASE were all written in C. 


Mhtre is a good reason why 
• your database language was 
developed in C. In fact, there 
are many good reasons. 


C code is small. C code is fast. C code is 
portable. C code is flexible. C is the 
language of choice for today's professional 
developer. With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5.0, you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++. 


C speed - fast code, true executables... 

FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE. Now 
that's slow. For dazzling performance you 
need the true executables of C. With 
CodeBase you get the real thing, C code. 
Consider the following statistics, from the 
publisher of Clipper: 



"Sieve of Erastothenes" 

Benchmark for Prime Number Generation 
Shows C to be incredibly faster! 


C size ■ small executables, 
no added overhead... 

FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 


remember, those products are all written in 
C. So why do you need to lug all their extra 
code around? You don't. CodeBase is a 
complete DBMS, in C. No fat executables 
stuffed with unused code. No runtime 
modules. No royalties. Just quality C code. 
CodeBase is just what you need. 


data files with any logical dBASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReporter: 


C portability ■ ANSI C/C++ 
on every hardware platform... 

No other language exists on more platforms 
than C/C++. Why rewrite your entire 
application for DOS, Windows, Windows 
NT, OS/2 or UNIX? With CodeBase the 
complete C source code is included, so you 
can port to any platform with an ANSI C or 
C++ compiler. Now and in the future. 

dBASE Compatible data, index 
and memo files... 

You want the industry standard. You need 
compatibility. Sure, dBASE is the standard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all: 
FoxPro (.cdx), Clipper (.ntx), dBASE IV 
(.mdx) and dBASE III (.ndx). Now it's your 
choice, we're compatible with you. 

Announcing 
CodeBase 5.0 

The power of a complete DBMS, the benefits ofC 

NEW - Multi-user sharing with 
FoxPro, Clipper and dBAbE... 

Now your multi-user C/C++ programs can 
share data, index and memo files at the 
same time as concurrently running FoxPro. 
Clipper and dBASE programs. No 
incompatibilities. No waiting. 

NEW - Queries & Relations 
1000 times faster... 

CodeBase 5.0 now lets you query related 



Elle Align Database Groups Global Brlnt Query Sty 1 ®* Help 




Product Sales Summary 

Month ol: Nov. 1992 

Product Quantity Value 

Database 63 *25.137.00 

Spreadsheet SB 821.866 00 

Monthly Summary 121 $47,003.00 

: Product Sales Sumri 

Month: Header: Ob|ects: 5; Height: 48.0 Points 

Month ol: |M/ Lid 
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Body: Header: Ob|ects: 3: Height: 14.0 Points 
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Month ob Dec. 1992 

Product Quantity Value 

Database 62 *24.862 00 

Spreadsheet 53 *19.87500 

Monthly Summery 115 $44,737.00 



Summary; Objects: 3; Height: 36.0 Points 
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Summary 236 $91,740.00 

To use CodeReporter. 



simply draw your report, then include it in any 
program you write. Call 403/437-2410 now for 
your FREE working model of CodeReporter. 

New - Design complex reports 
in just minutes... 

Our new CodeReporter takes the painstaking 
work out of reports. Now simply design and 
draw reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application. 

SPECIAL - FREE CodeReporter 

Order CodeBase 5 before August 31, 1993 
and receive CodeReporter for free! This 
offer includes our no-risk, 90-day money 
back guarantee, so order today! 


k M 





CodeBase 5.0 

The C/C++ Library for DataBase Management 

Call Now 
403-437-2410 


SEQUITER III 

SOFTWARE INC. III! 


P.O Box 575 Newmarket NH 03857 


FAX 403-436*2999 
UK Tel. +44-81-317-4321 
France +33.20.24.20.14 


01992 Sequiter Software Inc. All rights rcsened. CodeBase is a trademark of Sequitcr Software Inc. All other trade names referenced herein arc property of their respective companies. Advertising by MicroAns 
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ANOTHER DEBUGGING BREAKTHROUGH 



I MICROSOFT-. 

windows^ 

IcoMR^TlRFC 


...—' 

Automatic Bug Finder For Microsoft Windows 


BOUNDS-CHECKER FOR WINDOWS! 


NEW! BOUNDS-CHECKER for Windows is the only totally automatic 
solution to your Windows memory corruption, heap corruption and resource 
leakage problems. 

BOUNDS-CHECKER for Windows is an easy to use utility that automatically 
detects problems in your local heap, global heap, stack or data segment. It also 
tracks resource allocation / de-allocation, performs full parameter checking 
(even when not using the debug kernel) and handles all Windows faults. In one 
step, you can quickly and easily flush out some of the most aggravating bugs that 
a Windows programmer is likely to encounter. 

Using BOUNDS-CHECKER for Windows is simple, there are no changes 
to be made to your source in any way, and no linking of code or macros into 
your executable. When a bug is found, BOUNDS-CHECKER for Windows 
pops up showing you the source code that caused the problem. 


BOUNDS-CHECKER for Windows 
quickly & easily traps: 

• Memory and heap related corruption problems 

• Library routine over-runs of strings, 
arrays and structures 

• Attempting to free bad blocks 

• NULL pointers the instant they are referenced 

• Resources that were not freed 

(shows your actual source line that created the resource) 

• Errant parameters passed to API routines 

• Processor Faults 

Order NOW! Only $199 


For even more debugging power at a great value you can order BOUNDS-CHECKER for Windows in one of our package 
bundles that include other Nu-Mega debugging tools: 


BOUNDS-CHECKER for DOS & BOUNDS-CHECKER for Windows $298 
BOUNDS-CHECKER & Soft-ICE (DOS or Windows versions) $499 

Get all 4 products (BOUNDS-CHECKER & Soft-ICE for DOS & Windows) $770 — SAVE $400! 

We're making C/C ++ a Safe Language! 


Coll (603) 889-2386 
(603) 889-1135 

i 

'¥ N 

u-Mesa 

RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

^TECHNOLOGIES INC 

24 HOUR BBS 
603-595-0386 


BOUNDS-CHECKER FOR WINDOWS, SOFT-ICE, AND NU-MEGA TECHNOLOGIES are trademarks owned by Nu-Mega Technologies, Inc. All other trademarks are owned by their respective owners. 
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